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by Ed Ringed 


MacTECH MA<^ZfNE'S DATiyiASE PROJECT 
^ VC%h the fi&eus Vve asked 
ltd Riiigei, Mac^reeh's Gonthbuting Editor for prodycr revie^^, to 
M m a little bit about why he thinlcs database technologies are 
to all Madntofih developers. Ed has been working for 
piiny months to bring us infonrialion about many of the datal^ase 
available for iistvin Macintosh ptogr^is. results of 
pf his work api?ear in thfe issue; he also is respahsible for 
US several database articles over tlie i^st year and a half, 
yfet ihore will appear in foture issues. 1 hope you enjoy liis 
jgu^ editorial. ~ Eric Gundrum, Editor Emeritus 

If you riffle through the last year's or so issues of MacTech, 
you will note several database related articles^ such as those 
alKHil PowerBuilder for Macintosh and R-Tree Helper. This is.sue 
is a continuation of our atlcnipt to address one of the basie issues 
of computer programming and software development, the 
management of large amounts of data. 

Certainly^ many off llie shelf pnidncls clo not deal with dabi that 
is managed in a database — graphics and word f)rfx:cssing 
pa^grams come to mind almost immediately. However, such divei-se 
functions as investing our mutual funds and querying our bank 
accounts, managing t?ur heallii care, ihe management of corporate 
America, and our right to vc.)te de^xmd on die ability to mani[iulaie 
formatted inibrmation in a predictable, easy, and useful manner. 
Tliose cjf you wlio do coniracl programming almtAsl certainly have 
undertaken a database or infonmiion management pnxJuct at .some 
time or another. Sadly, tlie Mac OS often has not ix^en chosen as the 
platform for management of this kind of information, 'fhls is partially 
because of die aitifidal ascendancy of die Wintel plafform, [)ut il 
also is partially liecause of the perception of many IS professionals 
that the Mac has inadequate t(x)Ls for the ta.sk. We want to put the 
latter misperception, at least, to rest. 

In this Issue we present articles on two high end products dtF 
and NeoAcces.s, for your evaluation, and an additional article on a 
rather interesting find, Juvls. dtF and NeoAcc^ss are p<iwerfLil 
databases widi inherent emss tiladbnii capal>ilides. Jovis, although 
inherently not as versatile as die otlier two because of iLs 
confinement to the XCMI) (and thus the M:ic OS) world, 
nonetheless dexjs wliat it dtx.s very well All three of these products 
can do a fine job of managing complex inftmnation for many users. 


All three of these products also suptuort the developer in the 
development <jf static km)wledge bases with the capability to 
handle large, arliitrary bkxks of binary data. Although a departure 
from ^'traditional” information management, this is a growth area for 
the use of database engines. This should be an area of paniailar 
interest to the Mac developer. Tlie Mac’s Ix^auliful graphic:^, 
excellent printing, and ease of programming multimedia make the 
platform a natunii for static knowledge bases. 

What am I talking alxjud* As I browse die catalogues and 
particularly browse tlte store shelves, much of die software sold 
at the retail level simply is not a new w^ay of manipulating data. 
Rather, the purcha.ser is buying the mibrmarion on the CD, not 
liie program diat [presents it. Sadly, it is very liard to come up with 
a new program that genuinely is a better mousetrap, and many 
talenied developers spend much time and treasure trying to write 
the next PageMaker or Excel. Face it guys, for most of us, that 
ain't in the cards. Additionally, the reality is that tlie programs out 
there that do most computational tasks are pretty good; the 
competition is pretty stiff Reflecting this fact, and reflecting the 
public’s Imnger for consumable stuff, concentrating on 
information rather than software, may be a better tack for many 
developers. Many interactive games (shon of arcade games) use 
a relatively simple shell that really is a multimedia display with 
decLsion points and programmed responses. Teaching CD's, 
information CD'.s, and my movies CD froni my Ioc'hI video store 
don't sell the information player, they sell the information. 

Arguably then, eonlent development is [rretly darn 
important. Good quality, easy to use tools such a.s theese weVe 
reviewed here give the developer breathing rfx)m to think about 
content, structure, and esthetic appeal of the presentation. 
Certainly, we will continue to want high-quality code 
programmers to flower and prf>sper, but niiiny of us can create 
significant works with our gooci understanding of 
communication and esthetics and by colkil)oniting with our 
colleagues who are content expert.s. Tliis may be more important 
to professional success than shaving another niicrosecond from 
a rendering routine. Tliink about it. 

Our reviews of this imptjrtant area are not complete. We 
invite vendors and readers to let us know abt)ui their favorite 
engines, and we'll try to evaluate them. He careful, though, you 
migiil gel lapped to be the aullior of itie review! D 


Ed Ringel b Cyniribuiing Editor for product reviews for Mac'icch Maga^Jinc. When he s not working at the computer or enjoying the Maine lakes and 
woods, he’s a respiratory and critical care physidan in Waterville, Maine. He can be reached at eringcl©mint.net 
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GETTING 

STARTED 


Dave Mark 


Having a Dialog with Your Mac 


Programming the Dialog Manager 


In last month's column, we explored the inner workings of 
the Menu Manager This monih, we’ll build on that experience 
and create a program with menus, windows, and, for the first 
time, dialogs and alerts. This program is the biggest one we’ve 
tackled so far, so this months column is a bit longer than usual. 

CiuiATiwG 'ni£ Dialogger Resources 

WeT start off just as we did in last montii's column, by 
creating our MRAR and MEM! I restmrces. Create a folder inside 
your I^evelopment folder named "Dialogger Folder" Next, 
launch ResEdit and create a new file called Dialogger.rsrc inside 
this new folder. 

Now select Create New Resource from the Resource menu 
and CTcale a new MBAR resource according to tlie specifications 
in Figure 1. As you can see, our program will feature three 
different meiiLks. 



Figure L Specifications for Diabgger's MBAR resource. 

Close the MBAR and MBAR picker windows and again 
select Create New Resource from the Resource menu. Create a 
MENU resource according lo the specifications in Figure 2. 
This MENtJ represents the Apple menu. Be sure that the 
menu’s resource id is 128, 



Figure 2. Specifications for the Apple MENU resource. 


Now create another MENU resource according to the 
specifications shown in Figure 3- This MENU fcprescnls tfie File 
menu. Be sure the MENU’S resource id is set to 129- 



Figure 3^ Specificaiiom for the File MENU resource. 


Now create one fmal MENU resource according to the 
specifications shown in Figure 4. 'this MENU represents the Edit 
menu. Be sure this MENU’S resource id is set to 130. 


Want to suggest an article for the 
magazine? Send your suggestion to 
<niailto:editorial@mactech.com> 
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The Ultimate FileMaker Pro 
Web Development Tool 

Why do scores of high-profile websites rely on Lasso? Why is a portion of Lasso technology 
embedded in FileMaker Pro 4.0’s Web Companion? With a feature set described as incredible, 
find out for yourself why Lasso 2,5 is the sharpest tool for creating online stores, discussion 
groups, response forms and countless other robust dynamic Web applications. 

Over 50 new tags including math, string and variable allow unparalleled data handling 
capability. Combined with an SSL server. Lasso allows for secure data transactions. Create 
embedded operations with the powerful inline command. Instantly upgrade FileMaker 4.0 
CDML tags to LDML with the Lasso Tag Converter. What's more. Lasso 2.5 Server edition 
supports multi-homing and offers superior performance over other Web servers. 

Find out today why Lasso is the award-winning tool which sets the standard for Mac OS 
dynamic Web database publishing. To order or for a reseller near you, please call 
425.646.0288. Download your free test drive version today at 
http://www.blueworid.com/lasso/download/. 
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Figure 4 Specijicatiom for the Edit MENU resource. 
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OK. dose up your MENU and MEfJU picker windows. This 
next part might be a little tricky. You1l need three PICT images, 
one of a dog, tine of an elephant, and one of a squirrel. If you 
don't have any of these handy, drop into your favorire graphics 
program and do the best you can. If you’re really stuck, just 
create pictures with the words Afghan, Elephant, and Squirrel in 
them. Paste all three pictures into your scrapbook. 

Back in ResEdit, Paste the pictures into three PICT* resources. 
Use Figure 5 as your guide. Be sure your afghan is PICT 128, 
your elephant Ls PICT 129, and that your squirrel is PICT 130. 




Figure 5* Three PICT r^ources. Note which resource id goes 
with which PICT. 


Actually, you can use any PICT images that strike your 
fancy. Once you understand what this program does and how it 
works, feel free to customize it to your own desires. 

Close the PICT picker window. Once again, select Create 
New Resource from the Resource menu. This time, create a DLOG 
resource. A miniature version of your desktop will appear with a 
window somewhere in the middle. Depending on the size of 
y()ur monitor, your DLOG window may appear somewhat scaled. 
When the DLOG editor appears, customize it according to the 
specifications in Figure 6. 


Figure d Specifications for the DLOG resource. 

Be sure that you click the dialog window type (8tfi from liie 
left) at the top of the editing windt>w. Also, be sure you uncheck 
the Initially visible and Close box check boxes on the right side of 
the window. This resource controls the appearance of a dialog 
box’s window. Now well create a re.source that defines the items 
that appear in this DLOG. 

Double-click the DLOG window (not the editing window, 
but the window that appears in the middle of ihe editing window, 
on the mini-desktop) and a DITL editing window will appear. At 
the same time, a Dfll item palette will appear (Figure 7). 31iis 
palette contains a list of all the items you t:an add to your dialog. 


© 

Button 


Check Box 

(8) 

Radio Button 

l±i 

Control 

T: 

Static Text 

|D1 Edit Text 

^ Icon 

L 

Picture 

liiil User Item 


Figure 7. The Dm item palette. 


When you start constructing a DTTL (Dialog ITem List), you 
always start with tlie OK and Cancel buttons. 'Ihe OK button is 
always item number one, and the Cancel button (if it exisLs) is 
always item number two. A.s you'll learn, these item numbers 
iiave special significance to the Dialog Manager. 

Click the Button palene, dragging to the left, on to your 
DITL window. The outline of a button will appear (F^re 8). 
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With support from Apple® and MacTech® 
Magazine, MacHack is "THE" conference on 
Macintosh programming and development. MacHack 
gives you the opportunity to meet and talk to Apple 
engineers who actually work on the technologies 
you will be using tomorrow. Network with Macintosh 
developers from hundreds of companies and discuss 
programming techniques and issues you are 
concerned about. Unlike conferences where you are 
being talked "at", at MacHack you will be conversing 
with other programmers about real topics that affect 
you on a daily basis. This conference, by definition, 
is technical! 



MacHack 1998 
The 13th Aaaual Cenference 
for Leading Edge Developers 
June 18-21, 1998 
Dearborn, Michigan 
keynote Speaker: 

Chris Espinosa, "Apple Employee #8" 


You are guaranteed exposure to some of the most 
technically advanced people in the industry. The 
conference is kept to a small size to encourage 
interaction. Events are created to foster relationship 
building, sharpen your coding skills, and educate 
you on a variety of topics - no matter what your skill 
level. In short, you'll mingle, network and learn at 
MacHack 1998! 

But that's not all. Developers at MacHack are at the 
bleeding edge of new and emerging technologies. 
Developers for Rhapsody, Java, Pilot, BeOS and 
WinCE wander around, just waiting to share their 
knowledge with all who are willing to ask. 

. Regisfrotion Fees until April 15, 1998: 
Attendee: $425 Speaker: $325 

After April 1 5th: 

Attendee: $525 Speaker: $420 i 

If you would like to be a speaker, please contact 
ExpotecK at the address below, | 

For more information or to register ^ 
contact Expotech at: 

1 1 264 Bedford Rd. 

Grosse Pointe Park, Ml 48230-11 16 

Phone: 313 882-1824 

FAX; 313-882-6942 

E-MAIU expotech @ao I. CO m 

WEB: WWW .machack.com ; 


Mddnftah a a tnaJemcidc of Appte Cofn^ All others to their wpectrve hoUers. MocHodt ond the MocHocit logo one Irodemorb of Expotoch, he. Not offilioted with (f* MticHox|TMJ Group. 















iiii uiiL ID = i:!B trom uiaibggi 



(E) Button 


S Check Box 


(i) Radio Button 


m Control 


T: Static Text 


[0| Edit Text 


& toon 


Picture 

F.1 

_■ 

ill User Item 


Figure & Drawing a biiikm from the pcUette window. 


When you release the mouse button, a new button item wil] 
appear. Double click this button item and a specifications 
window will appear. Fill it in according to the specs shown in 
Figure 9, Notice that the Enabled check box is checked. This tells 
the Dialog Manager to respond to this item when it is clicked on 
in a dialog b<jx. If the item were not enabled, clicks in it would 
be ignored. 



Close the spec window and drag a second button from the 
palette. Double-click it and enter the specs shown in Figure 10. 
Close the specs window. 


Want to subscribe to MacTech 
Magazine? Contact 
<mailto:orders@devdepot.com>, 
caU 800-MACDEV-l or 
805-494-9797, or 
fax 805-494-9798 


; Edit OITl item #2 from Diologacr^rarg \ 


Button 


Tent: 

IZl 


1^ Enabled 


Tap: [t 67 | Bottoms [187 

leUi |9d I Rignt: |l54 


Figure 10. Specifications for DflJ. item #2. 

This time, drag a Radio Button fromthe palette. Double-click 
it and make it reflect the specs shown in Figure 11, Close the 
specs window. 


Edit PITl Hem ^3 from OiqLogger.rsri; i 


TcHt; 


Rod Id Button 'w] 


\Enabled 


TOpl 40 


Left: 20 


Bottom: [58 
RiObt: |tlO 


Figure 11. Specificaiions for Dm item #3. 

Drag a second Radio Button from the palette and make it 
reflect the specs shown in Figure 12. 


Edit PlTi item ^4 from Oiplpgger.nrc ! 


Tent: 


Radio Bui ton 


Enabled 


Top: |b0_I Bottom: [/«_| 

Lett: |20 I Right: 1110 \ 


Figure 12. Specifications forDITl item #4. 


Drag a third Radio Button from the palette and make it 
reflect the specs shown in Figure 13^ 


Edit PITL item #5 from Dinloflaer^r^rt i 


Teul; 

I BBOio Button 




Top: |flQ I Bottom: [oc | 

Left; |20 | Right: ] 


Figure /JL Specificaiiomfor DffJ. item ^5. 
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Access, of course, fs everything. And if you Ye looking to AOL to provide it, you Ye 
*?!# out of tuck* With Earthlink, youll find that weYe up 99*9% of the time. You 
won*t be burdened with the annoying busy signals and disconnects AOL is famous 
For (nor their high prices: weYe still $19.95 a month). And because we have more 
local access numbers than any other Internet Service Provider, you can also get on 
the Net more easily. Speaking of easily, that's how you can get rn touch with us. Our 
phone number is cleverly listed below. Talk to you soon. 


PC MACAZIHE^ATl»(kS [m?] 


! 


MU 

Qd Rite werm 

EiOOd 

Poor 

Avrrasemwatnwt 
■(dcninlaiid ipecdj 

web ttvUifhtMT Suufu 

OvcmQ PerformuAU! 

Excelicitt 1 

Uultent 

Gwci 

PftM 

1 &D0d 

PtWT 


(888)QUIT-AOL. ext. 3 926 
Earthlink Still S19.95 

PER MONTH 



liarth U n k Net w< »rk 

It's your Internet.^ 


1^1998 EarthUn1< Network, Inc, All rights reserved. Trademarks are property of their respective owners. 


www.earthlink.net 





Next, drag a Static Text item front Uie palette and make it 
reflect the .spec:s in Figure l4. Notice that the Enabled check box 
Ls unchecked. Normally, user clicks in static text are ignored. 


i Eitit pm item *6 from OiatQgBPr.rsrc i 


TchIi 

I Static TBMt ▼ I 

□ Enabled 




lop: |a0 I Boltom: |38 | 

leH: ] in I Kiglit: |BI | 


Figure 14. Specifications for DHL item *6. 


[Mi DITL ID = 128 from Dialoggi 


Pick One: 

O Rfghan 
O Elephant 
O Squirrel 



□ ShQUJ Preuieui 


Next, drag a Check Box item from the palelle and make it 
reflect the specs in Figure 15. 


Cancel ] 


OK 

k_ 


Edit DIR Item from Plntoggcr.rarE g 



Enabled Top: [ 130 ] Baltom: 1148 | 

Left: [10 I mght: |l4T ] 


Figure 15. S}iecifkuiionsfor 0/7X item #7. 

Finally, drag a User Item from the palette and make it reflect 
the specs in Figure 16, As was die case with Static Text, notice 
that the Enabled check Itox is unchecked. A User kern just acts 
as a marking reckmgle. We ll use it as a guide for drawing a 
picture, later in tlie program. There may lx: times when you want 
your User Items enabled. For now leave it as is. 

Edit om Hetn *B from PJiilogflBrrtrc 

I U^er Item 

□ Enoblod Top: 110 | Oattom; 1110 | 

LefU |!2B | Right: |2^0 | 


Figure 16. Sf)ecifwations for DITI. item #5. 

When you dose your last item spec window, your DITL 
editing window should look like the one shown in Figure 17. If 
it doesn't, go back and check out your specs. If you need to make 
changes, you ain use the tools in the DITL menu, such as Show 
Item Numbers, Set item Number..., and Renumber Items.... 


Figure 17. Ihe completed DITL resource. 

OK, weVe almost done. Close the DITL and DLOG windows 
till you're back down to your main window. You might want to 
save at this point. HI wail... 

Select Create New Resource from tlic Resource menu and 
create an ALRT resource, 'fhe ALRT editor looks just like the DLOG 
editor. It should. Alerts ate basically simplified dialogs, easier to use 
and easier to build. (Top: 40, Left: 40, Boiiom: 145, Highi: 350) 

Selea Get Resource Info from the Resource menu and change 
the ALRT's resource id to 129. Next, close the Info window and 
change tlic DITL ID: field in tiie ALRT window to 129. We have 
CO create a DITL for the items in the alert and, since we’ve 
already got a DHT 128, we'll use 129 for the alert. 

In general, it’s a good idea to keep the ALRT and DLOG 
resource ids in sync with their respective DITL resource ids. Our 
DLOG 128 goes with Dfll 128 and AliH’ 129 goes with Dfll 129. 

Double-click the Al.RT window inside the mini-desktop. A 
new DITL resource will appear. You'll add two item.s lo the DITL. 
First, create a Button according to the specs in Figure 18. 



Figm^ 18. Sjjecificationsfor the alert’s OK button. 
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The best tool for text. 

BBEdit. The premier text & 
HTML Editor for the Mac OS* 


From those who know... 

'T Ve been tiding BBEclil for about a month and now 
find if invaluable. It seems to offer just the tools 1 
need not only for Hl’ML coding (whidi is whai 
1 Ixrughl it for), but alsoTor writing and 
research, which came as a surprise. 

As a devotee of light and flexibk vs. 
bloated and unwieldy, IVe taken to 
using BRFxJit for the daily grind 
of my writing chores. When 1 
gel bored, I just turn to ‘grep' 
and toy with some complex 
search and replace expression] 

Ihanks for your solid work." 


DavU Eddy Spker 
Aiisistant Director, 

Case Frogrtun 
John F. Kennedy 
School of Ctovcrnmenl 
I larvara University 

“1 use BBEdit every day and 
Tm continually blown away by 
the intelligent interface, the 
povrer user features like *grep^ 
search and replace across multif^e 
Bks, the syntax coloring, the FTP 
open Sc save, the configurabEty, 
Internet Cbnfig, everything. Every 
time I think of scimething Td like 
to see added to the program, 1 
discover that if s already tl\ere 
You guys really thought of 
everything! Wlien I use other 
programs, 1 find myself 
wishing for the features 
that BBEdit has.” 

Chris Varosy 
US Web/Dream Media 



<http://web.barebones.com/> 


B 



Bare Bones Software, Inc. 

Iljymi RO. Box 1048. Bedford. MA 01730 • main 781-687-0700 • fax 781-687-0711 


BBEdit is a trademort^ of Bane Bones Soliware, Inc. 'It Doesn't Suck" is a registered trademark at Bare Bones Software, fnc. © 1998 Bare Eiooes Software, tnc. A!1 rights reserved. 





























Next» create a Static I'ext item item according to tlie specs 
in Figure 19- Be sure the Enabled dieck box is unchecked. 


"Utr- 


I Static TcitT 


Edit DITL Hem *f2 from OtologgerTsrc 


TshI: 


3 


Dlologger demontirates thd 
PlBlog Monager,.. 01998i Dotre Mart. 


□ Enabled 


Top^ I? I Bo Mom: jss | 

Left: 175 [ WtqhU jg85 | 


Figure 19* Specifications for 0177* item ^2. 

Whew! I'hat's it. Quit ResEdit, Ix^ing sure to save your 
changes. Let's get to the project. 

Creating the Diaijogger Project 

Launch CodeWarrior and create a new project based on the 
MacOS:C/C++:Basic Toollx>x 68k stationary. Turn off the Create 
Folder clieck box. Name the project Dialogger.mcp and place it 
in your Dialogger folder. Remove SillyBaUs.c and SiUyBalls.rsrc 
from the project; we will not \ye using these files. From the 
Finder, drag and drop your Dialogger.rsrc file into the project 
window. You also can remove the ANSI libraries group from the 
project, because we won’t need them, eitlier* 

Select New from the File menu to create a new window. 
Save ii under the name Dialogger.c, Selea Add Window from the 
Project menu to add Dialogger.c to the project. Your project 
window should look something like Figure 20. 



68K Debug MaoOS 


©!<51b>| 


ij 

1 SI Fite 


Code 

l>ata 4 


^ # Or Swreesr 


0 

0 « 

♦ m 


¥ Q Dialogger .G 


0 

0 « 

• EJ 


^ RKiHirces 


0 

0 « 

© 


¥ ^ Dialogger.rsrc 


n/a 

n/a • 

© 


^ g*" Mac Libraries 


0 

a 4 

© 


¥ K MSL RuntinwbSK Lib 

0 

0 « 

© 


^ ^ MacOS.lib 


0 

0 * 

0 


¥ ^HathLib68k(2i).H> 

0 

0 4 

0 


5 files 


o 

0 




Figure 20* Dialogger project window. 

Rather than print the code here twice, we’ll go straight to 
tlie walk-through. You can type in the code as we discuss it 
below and you will end up wiiii the complete program, or you 
can save your fingers some effort and get the complete project 
from MacTech's ftp site <flp://ftp.macTediXQm/src/>. 


Walking Tiirough the Source Code 
Much of the Dialogger source code will Icxsk familiar to you 
from earlier programs. TIJ keep the chatter to a minimum. You’ve 
seen some of these consUmLs before. The rest I'll explain as we 
gel to them. One convention you should be aware of is the 
convention. Just as we did with menu items, coastants tltat 
refiea a dialog item sum witli the letter T. 

flDclude <CQ[itrolH.h> 

Ifinclude <Oialogs.h> 
llinclude 

^Include <Quickdraw.h> 

^include 

ifldefine 

iidafine kAboutALRTld 
jdefine kUialogResin 

^6efine kVisible 
Idefine kHoveTpFtont 
^define kNoGoAway 
^deflri^ kSla^p 

#dafine kFirstRsdio 

{ define kOn 
define kOff 


128 

129 

128 

true 

(llindowFtr) 'IL 

false 

7L 

3 

1 

0 


F.ach time you add an item to a dialog item li.st, the item is 
given a unique number. 'Ihe OK button always gets numter 1 
and the Cancel button always gets numlxT 2. UesEdit's DITL 
menu (which appears when you edit a DITL) allows you to 
renumber the items in a DITL, as well as turn tlie display cjf item 
numbers on and off. In general, ifs a good idea to write down 
(or print out) each of your DITL item id's once you finish your 
ResFxJit session and you start writing your axle, 1 usually create 
the item ^defines for my MENU and DITL resources right away so 
I won't forger them, 


jlfdefine iAf^han 3 

Ifdefine iElephant 4 

#def!ne iSquirrel 5 

IfdefiHG iShowPrevIfiw 7 

ifdefine iUserliem 8 

ffdeflne kieftHar^ln 5 

idefine kTopKargin 40 

idefine niApple kBaseResIB 

idefine iAbout I 


idefine mFlle 
idefine ISettings 
idefine iQuit 


kBaneRe^ID+i 

I 

3 


Dialogger makes use of three globals. gDone Ls set to tnie 
when the program is ready to exit. gShowPreview corresptmiis to 
the Show preview checklx>x in the Settings dialog. It is set to 
true whenever the check box is c:hecked. We could avoid the 
use of a global by using the same initial setting for Show 
preview each time we enter the routine that handles the dialog 
box. By using a global, however, the setting of the check box 
survives, even after the dialog is dismissed. 

Globals. .. / 

Boolean gDone* gShowPreview - true; 
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Order Directly from Our Web Site! 

Download the Architectural Overview 


www.neologic.com 


neoAccess 

Cross-Platform Object Database Engine 

NeoLogic Systems, Inc. 

1450 Fourth St., Suite iz, Berkeley. CA 947^10 
V, 51a.524.5S97 f. 510.524.4501 neolosic@neologic.com 


NeoAccess is the most powerful object-oriented database engine available. 

It displays electrifying performance—up to ten times that of its competitors. 
Behind its elegant programming interface is a fully optimized relational query 
engine tuned for short access times and an object cache with automatic 
garbage collection for nearly instantaneous access to previously used objects. 
All in a memory Footprint as small as 150K. 

Get the power of NeoAccess, and avoid the expense and administrative hassle 
of feeding the runtime fees meter. You pay one affordable price no matter how 
many copies of your application you sell or use. 

Others may promise cross-plat form development tools—Neologic delivers. 
NeoAccess is a set of C++ classes designed for use with popular compilers 
and application frameworks on Windows* Macintosh®, and Unix'" platforms. 
Source code is included so it can even be used with custom frameworks. 

Thousands of developers, including America Online'^ and Claris* have 
already found that NeoAccess enabled them to build fast, powerful internet 
applications in record time. That’s why there are more copies of NeoAccess 
based applications on end-user machines than any other object database 
backend. Tap the power) 

M-F 9am to 5 PM Pacific; l-800"9^9"6353 

For Information and 1-510-524-5897 

Customer Service: 


The same thinking holds true for gCurrentPICT, This 
global tells us which picture weVe currently looking at^ 
ensuring that the dialog's Show [>rcvicw brings up the current 
picture of my pet Fred. 

yhart gCurrentPICT - kBaseResID: 

As always, here’s a complete list of function prototypes. 

/•*“**'"“*” Functions 

void ToolBoxInit( void ): 

PicHandle LoadPICT( short picTD ) ; 

void Creatt>Window{ void ) : 

void MenuBarlnit{ void J: 

void EvontLoopt void ): 

void DoKventC HventRecord ‘eventPtr ): 

void HandieMouseDownt EventRecord ‘ovontPtr ); 

void iIandleHenuChoice( long menuChoice ); 

void HandleAppleChciio6[ short item ) ; 

void HandleFileCholoe( short item ); 

void DotJpdateC BventRecord ^eveiitPtr h 

void DoDialogC void ): 

void FlipControi( ControlHandie control ); 

void DrawPreview{ DiaiogPtr dialog, short pielD ); 

void SwitchFICT( void ?; 

The following two routines are part of System 7, and won’t 
work with earlier versions of the operating system, 

maln() inidalizes the T(x)lbox, then sets up the menu bar 
and creates tiie My Pet Fred window. Once tliaCs done, tJie main 
event loop is entered. 


void main( void ) 

I 

ToolBoxliiit (): 
HEnuBarliiit [J; 

CreateVindowO : 

EventLoopO : 

) 


Nothing new here... 

^««,^.««* 4 *M-*M**«*** Y 

void ToolBoxlnit( void ) 
f 

InitGraft Sqd.thePort ); 
luitFontsO ; 

IrdtWindowE [); 

InltMenusO : 

TETnit{)t 

InitDialogs( NLILh ); 

InltCtirsorC) : 

1 

LoadPfCT{) uses GetPicture() to load a PICT resource. If the 
PICT can’t be found, beep once, then exit. 

PlcHandle LoadPTCT( short plcID ) 
i 

PicHandle pic; 

pic ^ GetPicture( picID ); 
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if ( pic = NULL ] 

I 

^lysBeepC 10 ): /* CouMn'L load ihe PlCi* resource!!! V 
ExitToShollO : 

I 

return pic; 


CreateWIndowO loads the current PICT then uses the Rect 
tliat defines its border to define the size of a new window, 'fhe 
idea here is to create a window exactly big enough to hold the 
entire PICT. Of course, this wouldn’t be a good idea if the PICT 
was bigger than the entire screen. Hmmm... Is tliis an idea for a 
column on scroll bars? We’ll see..* 

r**^************^*******^ CtfMeWindow ™««/ 
void CreateWindQv{ void ) 

I 

WindowPtr window: 

PicHandle pic; 

itcct r: 

pic - LoadPICT( aCurrcntPlCT )\ 

r = C*‘pic) .picFranie: 

We really don’t care where on the screen the PICT is, we just 
care about its size. Well use OffsetRectO to nonnalize the Rect, 
moving it so ifs the size of the PICT, but so its upper-left corner 
Ls at die point (kLeftMargin, kTopMargin). 

OffsetRect(^r, kLeftMargin r.left. kTopMargin r,lop): 

Next, we use NewWindow() to create a new window. We 
could have used GetMewWindowO but we’d have to change die 
window’s size. Whatever floats your lx)at... 

window = NawWindowt NULL, fisr* "\pMy Pet Fred*^, kVlsible. 
noGrowDocProcH kHoveToFront. kNoGoAwny, OL ) ; 

If the window couldn’t lie created, lieep once, then exit. 

if ( window = MULL ) 

f 

SysBeep( 10 ); f* OiiddnT load the WIND R-source!!! 7 

ExitToShell(); 

I 

Since we created the window as kVisible, this call to 
ShowWindowO is rcdunUint, I prefer to leave it in, so it’s very 
obvious when 1 revisit the code at 3 in the morning* 

Sho wWind ow( wind nw ); 

SetPort( window ); 

1 

MenuBarInitO does the usual, loading the MBAR resource, 
adding the apple items to die menu, then dm wing the menu bar. 

/******“•**”**“ MenuBarlnii ""”*'7 

void ttenuBarlnit ( vyid J 

I 

Handle menuBar; 

MeniiHandle menu; 

menuBar * GetNewMBart kBaseResID }; 

SetMenuBar( menuBar ); 


menu = GetMeniiUandle t raApple 3; 
AppendResMenu( menu, ^DRVRl ); 
DrawHenuBart): 


EventLoopO and DoEvent() should be familiar to you. No 
big changes. 

EveniLoop «*«***7 
void EventLoopC void ) 

( 

Event Record e ven t: 

gDone = false; 

while t gDone ^ false ) 

I 

if [ WaitNextEvent( evaryEvent, Prevent, kSleep, NULL ) ) 
DoKvent( Levant ): 

I 

voidDoEventC EventRecord eventPtr ) 

I 

char theChar; 

switch ( eventPtr->what ) 

[ 

case mouseDown: 

HandleMouseDownC eventPtr ): 
break; 

case keyDowti: 
case autoKey: 

theChar “ evetitPtr->iiiaaaage & charCodeMask; 
if ( (eventPtr'Xinodiflers h cmdKey) I” 0 ) 
HandleHenuChoice ( Meni)JCey ( tbeChar ) ): 
break: 

case updateEvt: 

DoUpdate( eventPtr ); 
break: 

] 

} 


As you’ve seen in other programs, HandleyouseDown() 
processes the latest mouseDown event. 

r .—«««•««••««*«•«•• HandJeMouseDown 7 

void UandleMoaseDownt EventRecord ^eventPtr ) 

I 

WindowPtr window; 
short tbePart; 

long menuChoice: 


FindWindowO tells you which window, and which part of the 
window, the mouseDown occurred in. 

thePart = FlndWindowt eventPtr->where, ^window 3 : 

Depending on the part of the window the mouseDown 
occurred in, the event is handled accordingly. 

switch E thePart ) 

I 

case inMenuBar: 

menuChoice = MenuSelectt eventPtr )where ); 

HandleMenuChciice( menuCholce 3: 

break; 

case inSy-sWindow : 

SystemCllckE eventPtr. window ); 
break; 

case inCoDtent: 

SaleetViDdew( window ); 
break; 

case inBrag : 

DragWlndowE window, eventPtr“>where, 

^qd.screenBltsabounds 3 E 
break; 

1 
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*^Without a doubts the Premiere Resouree Editor 
for the Mac OS A wealth of time-saving tools. 

- MacUser Magazine Eddy Awards 

'A distinct improvement over Apple's ResEdiL'' 

“ MacTech Magazine 

""Every Mac OS deMeloper should own a copy of Resorcerer 
— Ijconard Rosenthal, Aladdin Systems 

""Without Resorcerer, our localization efforts would look like a 
Tower of Babel. Don't do product without it!" 

- Greg Galanos, CEO and President, Metrowerks 

“Resorcerer's data template system is amazing, 

- Bill Goodman, author of Smaller Installer and Compact Pro 

“Resorcerer Rocks! Buy it, you will NOT regret it/' 

- Joe Zobkiw, author of A Fragment of Your Imagination 


"Resorcerer will pay for itself many times over in saved time and effort," 
- MacUser review 


“The template that disassem bles "PICVs is awesomer 

- Bill Steinberg, author ofPyro! and PBTools 

“Resorcerer proved indispemsibte in Us own creation! 

- Doug McKenna, author of Resorcerer 





Version 2.0 


The Resource Editor for the Mac™ OS Wizard 


ORDERING INFO 


Requires System 7.0 or greater, 
1,5MB RAM, CD-ROM 

Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, PO's, or Visa/MO 
Taxes: Colorado customers only 

Extras (call, fax, or email us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 

MATHEIVLESTHETICS, INC, 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax; (303) 440-0504 
resorcerer@raathemaesthetics.com 


• Very fast, HFS browser for viewing file tree of ail volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 

• New AppleScript Dictionary (‘aetei Apprentice Editor 

• MacOS 8 Appearance Manager-savvy Control Editor 

• Power Plant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 


• Fully supported; it^s easier, faster, and more productive than ResEdit 

• Safer memory-based, not disk-file-based* design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/m arks/sol ects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez-Hke scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 
•Its own 32-bit I^ist Mgr can open and edit very largo data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX* etc. 

• Full integrated support for editing color dialogs and menus 

• Try nut balloons, 'ictb's, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


To order by credit card, or to get the latest news, hug fixe^ updates, and apprentices, visit our website. 

www.mathemaesthetics.com 














HandleMenuChoiceO handles menu seleciions from either ihe 
Apple or File menus. 

HanaicMoiuChoicc 

void HandleMenttCh 01 ( long menuChoice ) 

1 

short menui 
short item; 

if t laenuChoice i= 0 ) 

( 

menti = HiWotd( aennChDlne ); 
item = LoWard( nenuCholce ): 


DoUpdate 7 

void DoUpdateC EventRecord ‘eventFtr ) 
( 

PlcHandle pic: 

WindowPtr window; 

Reel r: 


The WindowPtr is embedded in the event's message field. 
Well need this in a bit. 

window = (WindowPtr) eventPtr >]neB£iagG: 


switch { menu ) 

I 

case mAppla: 

HandleAppleChoice( item ); 
break; 
case mFlle: 

HandleFileChoicet iteia ) ; 
b reak; 

I 

HiliteMenu( 0 ): 

) 

1 


HandleAppleChoiceO is the same iis in previous programs. 

Z**^'”*”*”**’ liandteAppleCiioice 

void HandleAppleChoice ( short iteni ) 

f 

McnuHandle appleMenu: 

Str255 accName; 

short accNumber: 

switch { item } 

( 

case iAboLEt: 

IioteAlcrt( kAbouiAhKTid. NULL ); 
break; 
default: 

appieMenu = GetMenuiiandleC mApple ) : 
GetMenuItetnText( appieMenu, item, accNaitie ); 
accNumber = OpenDeskAcc( accName }; 
break; 

I 


HandleFtleChoice{) starts off by deehiring a totally useless 
(and unused) variable. Feel free to delete this line of code. 1 don’t 
know what 1 was thiiiking! 

/^*^***-*»»»* HandkFilteiioice 

void HandleFileChoice( short item ) 

I 

short newPICTid; 


Since the window was created the exact size of the current 
picture, well load the PICT, make window the cuirent port, then 
draw the PICT in the window. 

pic = LoadPICTf gCurrentPlCT ); 

SetFortt window ); 

Beginllpdate t window ): 

r = wlndow->pQrtRect; 

DrawPlcLuret pic, ); 

EndUpdate C window ); 

1 


DoDialogO ts where die real aaion is. 


^M*«**M4**M4*4«Mt*+M****»M«M DoUialf^ 7 

void DoDialogt void ) 


DialogPtr 

Boolean 

short 

Handle 

Rect 

short 


dialog: 

dialogDone false: 
ttetnHit. itemType: 
itcjnHandle: 
i lemRect: 
curRadioButton; 


GetNewDialogO loads a DLOG resource (as well as iLs 
associated DITL re.source) with the id specified in die first 
parameter. The second parameter allows you to designate a filter 
function tliat will get called repeatedly as events txcur inside 
your dialog. {We won't use this filter frinction here. Maylx: in a 
future column). The third parameter detennines whether the 
dialog's window appears in front of all other windows, just like 
tlie corresponding parameter in GetNewWindow(). 

dialog = GetNewDiaiog( kDialogResID, NULL. kMoveToFront ); 


rf Settings was selected, oall DoDialogO tip die dialog 
box. If Quit was selected, set gDone to true which will cause the 
program to drop out of the main event loop. 

switch ( item ) 

1 

case iSettltigu: 

DoDialogO: 
btouk; 
case iQuit: 
gDone = true; 
break; 

) 

} 

DoUpdate{) gets called whenever the Window Manager 
generates an updateEvt, asking Dialogger to redraw the contents 
of the My Pet Fred window. 


Just as you would with a window, make the dialog visible 
and make it the current port. A.s you'll see, DialogPtrs and 
WindowPtrs are quite similar and DialogRrs can be passed to the 
same roudnes you’d normally pass a WindowPtr to. 

ShowWindow{ dialog ): 

SeiPorit dialog ): 

SetDialogDefaultItemO tells the Dialog Manager which button 
is the default button (normally the OK button). The default 
buttem is the button you’d like activated when the user hits the 
return key or presses enter. Tlie Dialog Manager will make sure 
to draw a bold outline around the default button, making it easy 
for the user to see. 

SetDialogDiifaiiitlttiiiiC dialog, ok h 
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SetDialogCanceIttemO performs a similar hmaion, allowing 
you to s|)t;cify tlic buLLon that gets activaLcd when the user types 
(nonnally the Cancel button), ok and cancel are predefined in a 
#include file to be 1 and 2 respectively, 

SetDialogCanceiltemC dialog* cancel ): 


Tills next calculation tells us which of our three radio 
buttons should be turned on. Radio buttons always travel in sets. 
Just like the channel selector buttons on your car radio, one 
button is always selected, and the others always off. When a 
radio button is selected its circle Is filled in, like the Elephant 
radio burton in Figure 21, 


Radio 

Buttons 


Frck One: 

O Rfgiion 
® Etephonl 
O Squirrel 


^ Shorn Preuretu 

[ Cancel ] [[ OK 



Figure 21, A sei of radio buUons. 


curKadioBittton ^ gCurrent.PTCT - kBaseResTD + kFIrstPadio: 


GetDialogItemO uses a dialog irenVs id to retrieve its type, a 
l^iandlc to it, and its lK)undmg Red. We’ll cast ilie reiricvcd liandlc 
to a ControlHandle, then use tlie Control Manager routine 
SetCk)ntrolValue() to set the value of the radio button control to kOn. 
As you can see, radio buttons have two legal values, f)n (T) and 
off (0), All controls have a limited range of values. Buttons, radio 
buttons, check boxes, and saoll bars are all examples of controls. 

GetDiaiogItein( dialog, curRadioButton* &itemType. 
&itemHandle* ^itenRect ): 

SetControlValue ( (CotitrolHandle) itemHaodle* kOn ); 


/l^ yo./jf-', ijufrmifis 

-Oc'i/jy TO 



• Create floating network licenses 

• Tie license to host name 

• Tie license to user name 
^ Tie to host ID 

• Allow as many users as desired 

• Have unlimited number of licenses on a network ^ 

• Add licenses on the fly 

" AutomaticolJy unJicense if opplication is moved or copied 
■ Generate expiring licenses for "Ml strength" demos 

• Works on Veltaw Box far Windows OS well OS MACH/Rhapsody 

• Comes with sample app and license key generator 


F/fOAf yom Fsttf/os AT 


csiffeine 



WWW,St one.com/JLiceEtser/ info@stone*com (505)-345-4SCKJ 


OK. Now our sSetup work Is done. WeVe set our controls to 
their initial values, and performed any necessary drawing, lliis 
is typical of dialog management. Now well enter the dialog 
loop, which will luring our dialog to life* Tlie dialog loop keeps 
going until we set dialogDone to true. Well do this when either 
the Cancel or OK button.s i.s pre.ssed. 

vhile ( E dialogDone ) 

I 


If ific Show preview check Ixjx Is supposed to be checked, 
we'll use GetDialogItemO and SetControlValue() to turn it on. By 
default, all dialog item controls are off. 

if ( gShowPreview } 
f 

GetDialcigItei33( dialog* IShowPreview* SiternType. 
liitetnHatidle, SUteniRect ); 

SetControlValue( {ControlHandle)ItemRandle* kOn )i 
I 

Our last step in preparing our dialog box is to call our own 
DrawPreview{) function. DrawPreview() check.s to .see if the Jihow 
preview check box is checked. If so, it will draw the miniature 
picture of My Pet Fred. Otherwise, DrawPreviewO will erase any 
exi.sting preview, then exit 

Draw? rev iew( dialog, cuiRadioButtoii + 

kBaseResID - kFirsiRadio ); 


King of all Dialog Manager nmLines* Modal Dial og() grab,s an 
event from the ev^ent queue, calls the filter function (if you’ve 
specified one), then processes the event. ModalDialogO sets 
itemHit lo the item clicked (if itie event was a mouseDown). 

MadiilDictlog ( HULC. SilemHit ); 

Now all you have to do is figure out what to do with itemHit. 

switcht itemHit ) 

[ 

If the dick wa.s in Lhc OK or Cancel buttons, set dialogDone 
to tme* 

case okt 
case cancel: 

dlalcgDone = true: 
break; 
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ll tlic click wafi in ih^ Show previt^w check box, we’ll Hip 
the value of the check box (tom it on if off, off if it was on) then 
call DfawPreviewO to redraw the preview area accordingly. 

case iShovPreview: 

GetDlalogItein{ dialog, iShowPreview, ^iteniTypet 
iiteiuRandle, SiitemKect )r 
FllpControl( (CoatrolHandie)itemHandie ): 

DrawPrevlewC dialogs cJirRadioButtcui i 
KBaseResID kFltslRadlo ): 
break; 

If one of the radio l)uttons was clicked, we first check to 
make sure it wasn’t the lit one. If the lit one was clicked, there's 
no reason to do anything. 

case iAfghan: 
case iElephant: 
case ISqiilrrel: 

If ( curRadloBiitton 1= itemHit ) 
t 


If a new one was clicked, turn off the airrent button, then 
turn on the new one. Always turn off the old button beftire you 
turn on the new one. That way you won’t ever have two radio 
buLLons lit at the same time. This can be jamng to the user, 

GetDialogTteinC dialog, cut Radio Button, &itemType, 
&itninRnrt ): 

FllpContiolt (CariLrolHuudlc}!Lomaandle ); 

GetDialogIteni( dialog. iteinHit. SiteaType, 
&iteaHandle, £iltcmRect ); 

Fl1pControl( jContrclHaridle)iteniHandle ): 

Next, make curRadioButton reQeci the new current radio 
button, then redraw the preview. 

curRadioButton “ itemHit; 

DriiwPrevit*w( dialog, curRadioButton + 
kBaseRealR - kFitstBadlo ); 

I 

break; 

1 

I 


Once we drop out of the main dialog lf)op, well make the 
dialog window invisible. Even tliough it's invisible, we’ll still 
have access to its controls, so we can change some tilings then 
make it visible again if we want, 

EideWitidowt dialog ); 

If the dialog was dismissed with a click in Cancei, we don’r 
care about any changes made since the dialog wa.s opened. If 
ihe click was in OK (if the user firessed return or enter the 
Dialog Manager is nice enough to simulate the appropriate click 
for us), we’ll save the current value of the Show preview check 
box in gShowPreview. 

if { itemHit = ok ) 

I 

GotDialcgItea{ dialog, iShowPreview* &itemType, 

SiitcmHandle, SiitemRect ): 
if ( GetControlValuet (CcintrolHandle)itumHandle ) 
kOn ) 

gShowPrt^view “ true: 
el so 

gShowPreview = false; 


Next, if the state {)f the radio buttons kis cfianged, well call 
the routine Swt!chPICT() to switch the My Pet Fred window to 
reflect our new choice for a domestic destructive device. 

if { gCurrentPlCT != curRadioButton + 
kEaseResID - kFirstRadio ) 

I 

gCurreutPTCT = curRad j oBiitton + 
kBaaeResID kFirstRadio; 

SwitchPICTO; 

] 

J 

Either way, once we’re done, we call DisposeDialogO to free 
up all memory allocated for die dialog. If we hadn't made the 
dialog invisible first, this would have done that for us. 

OlspofieDialogt dialog ) : 

1 

FlipControlQ calls GetControlValue() to retrieve the current value 
of die control, then uses T and SetControlValueQ to flip its value. 

J lilx:onifoJ 7 

void FlipControiC ControlHandle control ) 

SetControlValue( control, ! GetControiValue{ control ) ): 

I 


DrawPreviewO first checks to see if the Show preview check 
box is off. 

void DrawPreview( DialogPtr dialog, short picID ) 

1 

PicRandle pic: 
ehort icemType; 

Handle itomllandle; 

Rect itemRect; 

GetDialogItem( dialog, iShowPreview, &iteraType, 

&itemRect ): 

if ( GoLCoulrolValue( {ControlHandle)itemHandle ) = kOff ) 
f 


If so, the preview' area i.s emsed and DrawPreview() returns. 

GetDlalogltemt dialog, itlserltem. &iloniTypc» 
HtemHandle, ^itemRect ); 

EraseRect{ ^itemRect ): 
return; 
f 


If the check box is checked, the current picture is drawm in 
the rectangle s|iecified by the user item. A.s you can see, die user 
item comes in handy for marking a rectangle in your dialog box. 
If you want lu move the preview area, just go into ResEdit and 
drag it around or resize it and your changes are reflected next 
time you run your program. 

pic = LoadPICTC picID ): 

GetDialogltemt dialog. iUserltem, SiltamTypo, 

^ItemHandle. SitemRect ); 

Fraii]f:RRCt( fiitemRect ); 

lnsetRcct( &itemRoct, 1, 1 }; 

DrawPicture( pic, SltcmRcct 3; 
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SwitchPICT() deletes the froat window, then creates a new 
window. Since CrGateWindowO uses the current picture to 
determine tlie size and contents of Its window, the newly 
selected pet Fred candidate will appear. 

.. SwUcKPlCr 7 

void SwitchPlCT( void } 

t 

WirtdtJwPtc window; 

window = FrontWindowO : 

DisposeWindow{ window ); 

CreateWindowO : 


Running Dialoggfr 

Save your source code and you’re ready to roll. When you 
run the project, a window should appear, just big enough to 
hold PICT 128. If you made your PlCTs too small, go back and 
fix them. Figure 22 show.s my window. 



Go to the File menu and select Settings (Figure 23). Play 
with all die dialog Items. Change some things, then select 
Cancel, verifying that tilings stay the same the next time you go 
into die dialog box. Uncheck the Show preview check box to see 
what happens. Play, play, play! 




Q0Vbound softi^ 

^ HIGH PERFORHANCE 

Imaging, Annotation & Plug-in 
Development Tools 

RasterMaster 7*0 Powerful, mutti-platform raster 
imaging support for 60+ Raster Formats, Familiar API and 
well-proven technology in use worldwide by companies 
such as BP, Chase Manhattan, Ford, Gannett, HP, IMSI, Kodak, 
LEXiS-NEXlS, Polaroid, Toyo, Unisys, Xerox and mom. 
Formats: TiF, JPEG, MO:OCA, CALS, PNG, DICOM, Flashpix, 
BMP. BRK, G3, G4, GIF, JEd, KFX, MAC, lOCA, pCX, TGA, 
WFX and more. Features indude: (‘ New for Vetsfon 7) 
•Compression * CMYK 4 Plane Support* 

Image Processing * 10^16 bit Grayscale* 

• Despeckle & Deskew *: Anglia sing in Silver* 

• Multipage TWAIN Scanning • Fit to VVidtti & Height %, 

- Pan, Zoom, Scroll • Tiled Image:Suppor||p', ^ 

- ImegeEditing .. Medical .I nnaglr^ 

Auto Aspect Ratio Animated GIF 

Alpha Channel Sup^rt ^ • Image Encrypilot 


^ Alpha Channel Sup^rt * - Image Encryption 

r iRaste rIN 0te 2,0 Annotatton/Redlinlng todlNtt* Features 
.ihgludei Sticky Notes,. Lines, Ellipses, Freehand Drawing; 

Highlighting, Redaction, Multiple Annotation layers: 

■' iS!«t ’ ■ • 

internet-Explorerv-:"' 

160+ Ra^r FonriatSf Sjimgte .drop In library makes it easy to 
Dhto ^,ndard browsers your intemet/lntranet pages, 

metude: Wm a&W lyiaoeewPC, UNIX, Alpha, OS/2 

DLU^/tebCriAdiyf^OCXt D^jlphi, FoxPro, PB^ VC++ ■ 's 

^LL 617*^03049^405 Or Visit Us At i 


i..ttetBn:l 


Si 


Pick One; 

O Rfghan 
® Elephant 
O Squirrel 


Shaui Preuiew 

3 ) 


Cancel 



figure 23. The Settings dialog box. 


Want to get up on a soap box? 
Send your opinions to 

<niailto:letters@mactech,com> 


Tiu. Next Month 

Wow, these columns arc getting long! That's the price we 
pay as we dive deeper into the Toolbox, t guess. Well, I’ll see 
you next month. ’I'iU then, read the Dialog and Control Manager 
chapters in Inside Macintosh: Macintosh Toolbox Ilssentials. 8Q 
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TOOLS OF 
THE TRADE 


hy Michael Marchetti 


NeoAccess 5.0 Revealed 


Taking a look at this high- 
performance object 
database management 
system 


Imw)uu(mt)N 

As a developer of custom software, I 
have the opportunify to work on a variety 
of projects, from the design phase all the 
way througli the maintenance cycle. In 
1989, llA designed and impleincnted a 
program which scored and retrieved a 
numl)cT of different kinds of data. Its data 
storage mechanism coasi.sted <^f MaeApp*.s 
dynamic arrays, stored in a simple custom 
file ftrrmat. Over the last eight years our 
requiremenLs changed in a number of 
ways, 'fhe sheer volume of data increased 
greatly, resulting in increased memory 
usage, longer search times, and longer 
program stanup times. New features 
required us to iniplemeni new access 
mechanisms, adding complexity to our 
original design. Finally, we were asked to 
port the program to Windows. Our Mac- 
cenlrit' data storage used Pascal strings 
and assumed big-endian integer and 
floating-point representatioas, Wc were 
looking at a major overhaul After 
evaluating a number of storage 
mechanisms, we chose KeoAccess. 


Wl£Y NliOAcCIiSS? 

At first, the idea of using a fuE-featured object database 
management system seemed like overkill As we evaluated 
NeoAccess, however, its advantages Ixicame apparent. 

NeoAccess does not load all of a dalal>a5e's data at once. 
lasLead, objects are brought into memory on demand and cached 
in a bounded amount of memory. A reference-counting 
mechanism allows NeoAccess to effectively manage Lite cache 
with minimal developer involvement, lliis provides developers 
with a numlxfr of benefits. 

• Memofy requirements: NeoAccess can store large 
amounts of data using a bounded amount of memory as an 
object cache. OhjecLs are reference-counted, allowing 
NeoAccess to effectively manage die cache with minimal 
developer involvement. 

• Startup time: Documents open faster because not ail the 
data is loaded at once. 

• FlexibiUty: NeoAccess allows die application developer to 
easily change the database formal and still support reading, 
converting, and even creating dalaba.ses using older formats, 

• Access meebanisms: NeoAccess supports relational 
queries as well as referential (object network) access, 
Dataliase developers can choose the most appropriate 
method for each situation. 

• Cross-platfonn compatibility: NeoAccess is available for 
Macinuxsfi, Windows, anti Unix, with a uniform feature set 
across all supported platforms. Daiabase files are written in a 
canonical form that can be read on any platform. 

• Object-oriented design: NeoAccess is written entirely in 
object-orienLed C++. DaLabases store and retrieve true 
C++ objects. 


Michael Marchetti cmniaahcUi@itainc,com> develops Macintosh soft^^are at ITA, Inc., a provider of rustoni software 
solutions located in Rochester, New York. 
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• Framework support: NeoAccess appliciition, d(K:umeat, 
stream, a.nd persistent ofiject classes arc integrated into the 
frameworks availal^le for each platfonn. NeoAccess also 
includes a ** stand a lone mode” for use with custom 
frameworks or without any framework. 

• MuUFtbreadin^: NeoAcccss can be safely used in a multi¬ 
threaded environment and takes advantage of asynchronous 
I/O operations to improve throughput. 

• Capacity: NeoAccess can store up U> A billion ttbjccLs per 
database. The Mac OS limits database files to 4GB; NeoAccess 
can be configured to use 63-bit file offsets on platform.s that 
support larger files. 


First Impressions 

Ihe NeoAccess 3.0 package 1 reviewed is for Macintosh only 
(the multi-platform version has identical core code but includes 
source and project files specific to the other platforms). The 
package consists of one CD and two manuals. The installation 
procedure involves simply c:opying the con ten Ls of Uic CD to a 
hard drive. The CD includes: 

* full source code to the ciatabase engine. 

* The complete manual in PDF ftjrm. 

* Several add-on features (called “Extras”), with source code 
and PDF documentation. 

* Two demo prf>grams with stiurce C4xlc and CodeWarrior 
projects. 

The two demo programs come pre-built in a numlicr of 
configurations, witli SYM files. This means you can use the 
debugger to learn how a NeoAccess program and the 
NeoAccess engine work. The demos come in different flavors 
for different framew[irks. Version 5.0 supporLs standalone (no 
framework) and PowerPlant. This is a change from version 4.0, 
which included support for MacApp 3-3 and TCL. 

The demo programs are NeoBench and Laughs. NeoBcnch 
is a bencivmarkmg program to test the speed of the database 
engine. Laughs illustrates most of the core constructs in 
NeoAccess, including inheritance, part managers, blobs, 
strings, and indices. Tlic documentalion includes a tutorial 
which describes the classes used in the Laughs application and 
how they interact. 


lEaiNICAL ImHODUCnON 

The main storage container in NeoAccess is the database, 
modeled by the class CNeoDatabase, A database is a file 
containing a set of objects. These objects are partitioned into 
classes which correspond to the subclasses of CNeoPersist 
defined in the program, (Application-specific cla.sses inherit 
their persistence properties from CNeoPersist.) The program 
.supplies NeoAccess with information about the inheritance 
relationships between classes. This enables the program to 
limit a search to objects of one .specific class or allow it to 
range over a class and all subclasses. 




“\i yov're a devekoer, yoi/Ve jfof to get TestTrmk. 
Your bugs will hate you for it!" Caul Juuf of the &uy 


sales@seapine.com 

http://www.seapine.com 


me 

'are 


Discover the tool today's top software developers are using to improve the 
quality of their Macintosh and Windows applitolions—TestTrock. 


• Track hugs, feature request, problems, 
customer inforimifkiii, and more, 

• New! E'Uiail nolilicoiions^SMTP and WAPI, 

• New! Import bugs vio e moil aufomatitalk 

• Produce concise reports, 

• Mylfiple users, full security-link engineers, 
testers, managers, even tecfi writers. 

• New! Improved help desk support, 

• New! Deferred defect numbering, esdernal 
nlfachmcnr storage, oistonner bug histories, 
and much, much, mare, 

• Aulomoticolly route hugs to teom members, 

• Track the history of each bug. 

• Sove lime otKl improve tech support by 
giving Solo Bug, TestTrock's stand-alone bug 
reporter, to ym custon^rs. 


OnlY$169J 2+for $149 each! 
To order coll 888-683-6456 
or 513-683-6456 


Download our demo today! 
http:// www.seapine.iom 


TestuMa 

Your Total Bug Tracking Solution 


Each class has^ a defined fiet of attributes (corresp^onding to 
its persistent data meml>ers) which are present in each object of 
that class in the database. Access to these artributes is through 
the virtual functions setValue() and getValue(), which die 
NeoAccess manual correctly descritnes as “the mother of all 
accessor funaions," They provide access to every persistent 
attribute of an object, and perform type coercion as needed (if, 
for example, the re<[uesied allributc Ls stored as a Pascal string 
and requested as a C string). 

Indices 

Each class has a set of indices associated with it. An index 
is a list of every object of that class, sorted in order of a particular 
artribute. Indices nfuike it possible to fine! objects efficiently and 
to iterate through a set of objects in order. 

Every class has at least one index, known as the primary 
index. The default primary index sons objects by object ID (a 
unique 32-bit integer assigned when die object is added to the 
database). AU other indices are known as secondary indices. 
These are mappings from attribute values to object IDs. When 
searching a secondary index^ NeoAccess uses die primary index 
to actually locate objects once their IDs are known. 

When the program attempts to locate an object widi a 
particular attribute value^ the NeoAccess ciuery optimizer looks 
for an index on dial attribute. If an index is found, a binary 
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search algoriiliTii is used to locale die olijcet. If the index does 
not exist, tlien a Kiiear search algorithm must be used. When the 
program requests an iterator in order of a particular attribute, 
NeoAccess lfx>ks for an index on that atlrihute, then iterates 
tlirough tlic index. 

Secondary indices can be added and removed at runtime. 
This is useful if access patterns tend to change over time or are 
based on user preferences. Indices dial are not frequently used 
can l>e removed to save space, while new indices can he created 
to index diose attributes that are most frequently searched. 

Part Managers 

NeoAccess also provides a construct known as a part 
manager. Part managers can be thought of as persistent lists, 
implementing a one-way, one-to-many relationship. It is also 
useful to think of part managers as secondary indices that index 
only a subset of the objects in a class (namely those objects that 
have been explicitly added to die list). 

For example, in a file system database, a directory object 
might contain a part manager which lists the directory contents 
in order of name. Tn fact, i! mighl have several part managers 
sorting tile LontenLs by name, file si^e, and modification date. 
Keeping all of those part managers synchronized in the presence 
of system crashes ami other anomalies could be problematic. 
One solution to the problcni is to l3uild the pari managers 
dynamically when the directory is accessed. This can l:>e easily 
done using queries. 

Queries 

A query is a persistent object which contains multiple part 
managers sorted in different orders. Objects are placed in the 
pan managers by executing a Cjiiery. In t>ur example, we njuld 
assign each item a parent directory ID, and make a query to 
select those items with the desired parent ID. Since queries are 
persistent, both the selection criterion and tlie list of objects can 
lx: saved in tlie database. It Is also simple to execute a query, use 
the results, and then discard the resulting lists. 

Selection 

NeoAccess defines a specbilized mechanism for expressing 
selection criteria, 'Ihere are a number of ^selection key" classes 
which inherit from a base cla.ss of CNeoSelect. Most of them fall 
into the category of type-specific keys, CNeoLongSelect is used 
for long integer attributes, CNeoStringSelect for string atcribute.s, 
and so on. These keys can be configured to .search for an exact 
match or use another criterion such as iess than x’' or “greater 
dian X". 'fliere are also '‘complex keys," which combine multiple 
edteria into a single key. These include Boolean AND and OR as 
well as value ranges. Selection keys are used in all of the calls 
which reuieve data: 

• findObject locatCsS an object in the database matching the key. 

• getiterator returns an iterator object, which tlie caller can use 
to walk through a set of objects in the database or in a part 
manager. 


• CNeoQuery olrjects construct one or more sorted lists of 
objects matching the key. 

Blobs 

Some entities, such as image and movie data, cannot be 
easily represented with objects. NeoAccess provides a type of 
object, known as a blob, that .simply su>re,s a chunk of data. Thi.s 
is useful for image data, movies, and long text strings. Blobs can 
l:je indexed like any other field by using the CNeoBloblndex class 
included with NeoAccess. 

Dynamic Objects 

Another optional component of NeoAccess is the 
DyoaObjecl facility. When it is enabled through a compile¬ 
time flag, applications can add and remove attributes from 
persistent object classes at mnUme and even create new 
classes on the fly. NeoAccess autumalically maintains a 
prototype object for cacli persistent class and creates new 
instances from the prototype, 

Wliat’s New 

NeoLogic is constantly working to improve NeoAccess. 
Version 5-1 was just released when this article was written. It 
includes several new features and performance improvements. 

IiLTators can now be configured to keep track of the total 
number of entries and current position in the collection. This 
makes it much easier to implement .scrolling lists efficiently. 

The disitributed object facility allows location- 
independent access to objects. This makes it possible to treat 
multiple databases as if they were one, For example^ it is now 
possible to create an index in one database (the “host") to index 
oirjccLs stored in other databases (tlie “targets"). NeoAccess 
automatically opens and closes the target databases as needed. 
Fan managers, queries, and swizzlers also implement object 
refercnc:e,s that can refer to olijccts in other databases, 

A general-purpose test harness allows developers to test 
their database code by sulx:lassing a generic test class, TesLs 
can be grouped into suites and scheduled to run sequentially 
or in random order, once or multiple times. 'I'he test harness 
has a commanddine parser that passes parameters to the tests, 
allowing different options to be selected at runtime. 

Performance 

1 ran the NeoBench program on a PowerMac 7200/120 witii 
VM off and a 256K .system disk caclie. In a 15(K)K partition, 
NeoBench had alx)ut 1200K free and used half (dOOK) as an 
object cache. I ran two sets of tests: one with 2,000 objects and 
one with 10,000 objecls. This yielded the following performance 
results (in opemtioas per second): 
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2,000 objects 

10,000 objects 

In.seri 

1.030 

1,140 

Locate Randomly 

14,600 

11,000 

Locate Serially 

148,000 

146,000 

Change 

1,140 

1,220 

Delete 

7,170 

8,800 


Notes 

1. The insert, change, and delete phases include commirting 
changes to the database file- 

2. Enabling debugging code decreases engine performance by 
about one-third for tiiost operations. 

3. Version 5-1, jtJst released, has performance opTim^z^llion,s 
beyond those used in this test. 

As you can see, NeoAccess achieves very fast access 
limes. Like many benchmarks, NeoBench does not 
necessarily reflect the performance of real applications. It 
does a good job of testing the speed of the primary index, 
iteration, and object I/O, However, the persistent object clas.s 
in NeoBench does not have any secondary indices. Each 
additional index slows down the insert, change, and delete 
operations. In addition, locating objects in a secondary index 
is slower than using the primary index. 


IXXIJMENTATION 

NeoAccess does have a rather steep learning curve; new 
developers are presented with around 60,000 lines of code 
totaling 2MB. The documentation copes with this volume of 
information in three ways. First, the manual contains an 
introdyctory section explaining the concepts we have seen 
here. Second, most of the manual consisLs of the class 
reference. Third, the manual includes a tutorial section that 
explains the internal workings of the Laughs demo program, 
one section at a time. Since Laughs uses a large subset of 
NeoAccess, this section is useful as a quick reference with 
code examples. 

Users of previous versions will notice significant 
improvements in the documentation. In particular, the 
introductory .section now includes instructions and code 
snippets showing how' to use the basic features of NeoAccess, 
The reference section includes more hac:kground infomtalion 
on a number of classes. 

As more complex constructs are introduced (part managers, 
blobs, dynamic objects, etcj you will have to override more 
NeoAccess tunctions in your classes. Although the 
dcKumentaiion does a pretty good job of explaining what to 
override, it remains a tedious and error-prone prtx'ess. NeoU)gic 
is planning to simplify this procedure in a future release. 
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*ro use some of the engine’s capabilities, developers must 
mtxlify liie NeoTypes.h include file. It contains a number of 
compile-time flags controlling a huge amount of functionality, as 
well as common type declarations. It would be nice if this file 
was split into a file containing the type declarations and a 
“developcT-modifialjlc” file containing tlie compile flags which 
we could keep under source control for differnt projects. 

DeBUCiGING 

Debugging NeoAccess programs can be complicated. 
There are a lot of assenions built into the database engLne to 
check all sorts of things: parameter values, usage, and 
database consistency. However, even with those cheeks, it is 
still easy to write code that fails without producing an error 
message. One particular problem is when objects don't sort 
correctly. Usually tliis means that an index is missing, or 
indexed attributes were modified without updating the index. 
It would be helpful For these cases to at least produce 
warning messages. 

Since NeoAccess is based on btrees, debugging can involve 
a lot of navigating through complex data structures in the 
debugger. 1 would like to see the debugging guide in the manual 
expanded to include a liasic overview' of liow to examine classes, 
indices and part managers. 

PlJRCHASING 

NeoLogic offers several dilferent NeoAccess packages to 
meet different needs. All licenses are priced on a per-developer 
basis. There are no rtintime licensing Fees or royalties as long as 
the target application does not have a programmatic interface to 
persistent data (that is, an APT or plugitis) and Ls not a 
development tool. 

The ain^ent prices are: 


Developers 

platforms 

Transferable 

Price 

1 

Single 

No 

$749 

1 

All 

No 

$1,499 

1 

All 

Yes 

$2,999 

25 

All 

Yes 

$12,500 


Upgrades 

Upgrade prices are based on the price of the original 
toolkit. Minor upgrades (5.1) cost 1/6 of the onginal price 
($125 to $500). Major upgrades (6.0) cost 1/3 of the original 
price ($250 to $1000). NeoLogic also offers a subscription 
plan at an annual cost of 2/3 of the toolkit price. 
Subscriptions include all upgrades for a year, plus one hour 
of technical support, 

There is one significant fiaw in the NeoAccess update 
policy. As developers report problems with the database 
engine, NeoLogic generates bug reports and bug fixes. 
Perio<iically, these are incorporated into an official release 
(currently 5.0.5) and the patches are posted to the Neoixigic 
w'cb site. Developers can download and apply these patches, 


but there is no way to obtain a "clean” bug-fix release (except 
for members of the NeoAccess Partners Program). Developers 
who bought 5.0 have already applied around 58 patches. It 
would be much simpler to have all the patches for a 
particular release encapsulated into update programs that we 
could download and run, or to provide entire files or 
functions instead of patching instructions. This may not seem 
like a big deal, truL ids not pleasant to go through 58 of these, 
hoping to apply them all correctly. 


347 Ctash Rasolved 5.0 - 5,0.5 All All All All 
THeoSwizzler-Cpp 5.0.6 

Applications using TNeoIDEwiszier objects crash when 
assigning a nil pointer to the swizzler. 

Correcting this problem involves adding an additional check 
in the THeoIDSwizzlen iope.ratcir=(pPerslst *aOhject} assigntnent 
operator. The (aObject \’^ fObject |1 a0bject->£lD != fID) 
conditional at the top of the function needs to be changed to 
(aQbject != fObject || (aObject a0bject->flD != fID) || 
UaObject 66 fID)). 


Support 

Technical support is provided by email, free for 30 days 
and $ 120/hour thereafter. Questions about NeoAccess (asking 
how to accomplish something, or why a particular code 
sequence fails) generally receive prompt and useful answers. 
Some of the more difficult debugging problems (corrupted 
databases, for example) can't be solved without careful 
examination of the code. These types of questions are likely to 
be met with general debugging advice. The free tech support 
specifically excludes application-specific support; it seems 
reasonable to expect clients to pay if tliey want NeoLogic to 
debug their programs. 

There is an email discussion group devoted to NeoAccess, 
where it is possible to get help from other developers who 
have had similar experiences, NeoLogic personnel often post 
responses to technical questions, and we have generally found 
this to be an excellent source of technical help (though this is 
no substitute for NeoLogic tech support when you really need 
it). Instructions for subscribing to the list are included on the 
NeoAccess CD. 

NeoLogic also offers quarterly and annual support options. 
These all include free upgrades; NeoAccess Partners can 
download bug-fix releases and beta releases. 


Plan Months 

Upgrades 

Support 

Price 

Subscription 

12 

Yes 

1 hr. 

$500 

Quarterly Support 

3 

Yes 

20 hrs. 

$1,500 

Annual Support 

12 

Ye.s 

80 hrs. 

$5,000 

NeoAccess Partner 

12 

Yes 

80 hrs. 

$7,500 


Code Snippets: Appucatcon Level 
Here are examples of how to use some of the basic 
funaionality of NeoAccess from the application level. The low- 
level code needed to support tliis is piesented in the next section. 
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Some things to note alx>ut this code: 

• gNeoDatabase is the NeoAccess global variable for the current 
database. If you are using a fmmework, the NeoAccess 
document ebsses ensure tliat gNeoDatabase always points to 
the front document’s database. 

• The template class TNeoTracker is similar to the auto_ptr 
class. When it goes out of scope (either by returning from 
the function or tlirowkig an exception), its destructor wili 
delete the iterator. Without TNeoTracker, we would have to 
have a try/catch block in each of the functions that uses an 
iterator. 

• The tempiate class TNeoSwizzler is analogous to 
TNeoTracker^ but is intended for use with persistent objects. 
Since persistent objects are reference-counted, application 
code may never use the delete operator on them. Swizzlers 
add and remove references as needed to maintain reference 
counts, even in die presence of exceptions. (Note that new 
and findObject return an object with a reference already 
added, so we explicitly call unrefer in those cases.) 

Listing I _ 

void CreateDatabasotconst KeoFileSpec& flleSpecJ 

I 

// Make the daiaba^ object 
CNeoCatabaseAione* aOatabaae “ 

Neotlew CNeoDatabafleAlone{kFileCreator, kFileTypo)j 
gNeoDatabase ^ aDatabase: 

aBataba3&’>SpeclfyFSSpeci&filaSpec)j 

// Allow ibc NcoAjCCcss nKTHOr)' juamger to write out changes to tree up memory 
aDatabase- >setFuC£eAction(kNeoGoii!ffiitBef oroPutge): 

// Create the database file tm disk and open it fbr writing 

aDatabasa->createO : 

aDatabaee- >open (NeoReadWrl tePem) i 


lis ti n g 2 _ 

AddPcfson 

Adding tn the dataha.se 

void AddForaon(const char* mm, NeoDotible salary) 
f 

// Create the object 

CParaon* person " NeoMev CPeraon; 

// nil In attributes of the person. For setValuc, speedy the tag 

// (or the attribute we want to set, the type of the value we arc 

il supplying, and a pointer to the actual value. 

person )setValue(pPersonNanie, kNeoStringType* name); 

person‘>setValue(pSalaryt kNeoDoubleType, ^salary); 

gNeoDatabase^ >add0bject(person); 
person->unreferO; 


Listing 3_ 

HndPersonByName 

Fmdi^g an object 

CPerson* FindPersonByNaroe(const char* name) 

{ 

// Make a kq' to selea the people named cyme'. 

// pPtrsonNamc is an access tag indicating the name aitribuic. 

// name is the value wc want that attribute to bavc. 

CKeoStringselect key(pPersonNaffle. name): 

// Find the object in the databa.se. If mtiie than one match, only one will be 
returned. 

CPerson* person - (CPerson*) 

gNeoDatabase >findObject(kPereonClasslD, &key): 

return person: 

I 


Listing 4_ 

Using an Iterator 

The swizzlcr will add a teferenoe to whatever oh^ is assigned to it. When a new 
object is assigned, the lefeieocc will be removed from the pievious objccL 

void PrlntPeoplelCNeoTterator* iter) 

I 

TNeoSwiaaler<CPerson> person; 

fori person = (CFersoti*) iter->gurreiitObj€ct(): 
person !“ nil; 

person - (CPerson*) iter->ne^tObject()) t 

PrlntPerson(person); 
i 
I 

void PrintPerson(CPerson* person} 

1 

if{perfion = nil) 1 

printf( “Person Is nil*\n'‘); 

1 

else \ 

// Request name and salary 
char name[kHaxNameLenJ: 

NeoDouble salary: 

peraon->getValne(pPerBonName, kNeoStringType, name); 
person->getValueCpSalary, kNeoDoubleType, ^salary); 

printfname* salary); 

1 

1 


Listin g S _ 

[Tcrating. unordeted 

Iterating with a nil key will give us every object in the primary index (tlicrdbre they 
will be in order of object ID, not alphabeiicaJ by name). 

void PrintPeopleUnorderad0 

I 

TNeoTracker<CNeoTterater> iter; 

iter “ gNeoDatabase >gotIterator(kPorsonl0* nil); 

PrintPeoplelitec): 

1 


Listing 6__ 

Iterating, ordeied 

Wc make a selection key with the tag pPersonName.Thb icds NeoAccess to use the 
index soned by name, lids aUows us to iteiate in alphabetical onkr 

void PrintPeopleOrderedO 

I 

CNeoStringSelect key(pPersonName* ■"■); 
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// Make the key matdi everyitiii^ ^ we see all of the names 
// (we use the key only to indicate which index lo uaversic), 
key .iJGlKalchAII Ctrufj): 

THeoTrackee<CIjeQlterator> Iter; 

iter f^eQDatabase~)getiteretor{kPorsonI[)» &key); 
PriotPeopleiiter): 


ListlngT _ 

Iterating over a subset 

Wc make a key to select only those people with sihries of at least minSalary, If there is 
a salary^ incfex.NeoAccess will use it to quickly locate the set of objects we rcquesied, 
atwl the results will be sorted by salary. Otherwise it will search all people (in tlic 
primary uidcx) to fuid any that iitatdi oor criteria, and the results will be sorted by 
object ID. 

void PrintHoneyHakers(NeoDouble minSalary) 

( 

CNeoOouhleSolect keytpSalary, minSalary); 
key.setOrder(kNooHighOrEqual 3 : 

TNeoTracktrCCfieoIteEator> iter: 

Iter ^ gNeoDatabaae->get!teratot(kPer$onID* fikey): 
PrlntPeople(lter); 


IMPLEMI-NTIIMG A PERSISTENT CLASS 

Now that we've seen how to use NeoAccess from your 
application, we can look at the lower-level code that 
impiements the CPerson class. This is a minimal class- using the 
advanced features of NeoAccess requires overriding more 
functions. The documentation describes when you must 
override additional funclitms and how to call the inherited 
Function. Also, there are plenty of examples of how to override 
CNeoPersisl functions built into NeoAccess. 


ti Acccsisur methods 

virtual Boolean getValue{ const tieoTag aTag* 

const NooTag aType, 
void *aValue) const: 

virtual Boolean eetValueE const KeoTag aXag. 

const KeoTag aType, 
const void *aValue3: 

private; 

// Declare the actual stufagje for the attributes 
CKeoString fName: 

HcoDouble fSalary: 

// Poiatcr to the mctachiss object represeoting this cbfks 
static CNeohetaClass* FMcta; 

]: 


listing 9 _ 

Implemenuttion of CFcrson 

CNeoPersist' CPerson; ;KewO 

I 

If Static function to citate person objccis/rhis is registered as 
// part of the meiadass aod used inicmally by NcoAcccss. 
return NeoNew CPerson: 


long CPerson:rgetPileLengthEconst CMeoFotmat *aFonnatJ const 
I 

// f^rtPilcLaigih ; rctiuns the amount of space occupied by this object in the 
database. 

long Ion = Neolnherited:: getFileLength(aFarniat): 
len += siaeof(fName) + aizaofCfSalary): 
return len: 


void CPerson::readObjectE CNeoStreura ’aStremn, 

const NooTag eXag) 

1 

// readObjcct is responsible reading the object from the given stream. 

// By examining the stream's format object, we can supp(3rt older file versions. 
Neoinherited; :readObject CaStreaiHi aTag): 
aStream->readNativeStringE£Naiiit?. slaeof ffNaroe)): 
fSalary = aStraaraOreadDoubieO : 


Uniting 8 


Uecbfatkm of CFtrson 

sctValue and gctValiK^ are almost identical (as ore readObject and wriieOhjcct), so I 
have only one. 


// Dedore a unique lu for this object class, 
const KeoID kPersonID * 20; 


// IXTlore access mgs u.sed by sctValue and gclValue 

enuiti t 

pPersonNamc ^ 'Naaic\ 
pSalary " 'Siry' 


claan CParaon : public CKeoPersistNative \ 
public: 

// Perform any iniliall/^itkm specific to this class 
static void InitPersonClaaaE): 

// Instance methods 

virtual NeoIDgetClasalDE) const [ return kPersonlD: I 
static CHeoFersist *New(): 

// I/O Methods 

virtual long gerFlleLongthE 

const CHeoForwot ’aFomiat) const; 


boolean GFetson: :getV3lue( const WeoTag aTag. 

const NeoTag aType, 
void *aValue) const 
i 

// aTag indjeate^ what aUiibutc is being requested; aiypc indicates the 
// data type of aVoluc.Wc must eooven tiic data to the requested type. 

Boolean result ” TPUE: 
switch (aTag) I 
case pNeoName: 

if EaType = kNeoNatlveStrlngType) 

* ECNeoString’) aValue " iNaniq; 
else 

ConvertTypeE &fName, kNeoNativeStringType, 
aValue. aType); 

break: 

case pSalary; 

if (aType = kNeoDoubletype) 

*(NeoDouble*) aValue - fSalary; 
else 

ConvertType(&£Salary, ki^eoDoubleType, aValue, aType); 
break: 
default: 

result = Neolnhcrited:igetValueCaTag, aType, aValue); 


virtual void readObject ECNeoStteats’aSLrearo, 

const iieoTag a'l'ag) i 
virtual void wrlte0bject( CfleoStream*astreatn. 

const NeoTag aXag); 


// Return true if gaValuc was sueecs^ul 
return result; 
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Listing 10 

The metadass object legistcrs this class with NeoAccess, 


CPtrson Mctaclass Object 


CKooHetaCXflss' HeoHear CTerson::FHeta = 
KeoNow CKeoMetaClaasC 

kPcfsonlD, // ThisctelD 

kNcoPcrsistlD, // ftjtsc da^s TD 
“CPtrscm", // Qassrunie 

// Alloator function) UPP 
NeoNevCetOnePersi@t{CPerson::New)); 


void CPerson r:InltPersonClasa() 

I 

// This function should he called at program startup to perft>nn 
// additional initialiEailon as needed We use this opportunity to 
// add the name and salary indices to our mctacLiss object, 

// Since the itMikes are stock NeoAccess objecjs, this is all 
// wc need to do to add indexing on any attribute! 

FMeta-)addKey(kNeoNativeStringlndexID, pPersonHame); 
FMeta->3ddKEiy (kNeoDoublertidexIO, pSalary): 


Conclusion 

NeoAccess is a very powerful object database 
management system well-suiied to a wide variety of data 
storage applications. After overcoming the steep learning 
curve, developers should find the product relatively easy to 
use. The documentation is helpful, but mastering the more 
complex fealure.s of NeoAccess requires experience with the 
database engine. 

Tricing and upgrade policies are mostly reasonable. The 
lack of runtime licensing fees for most applications make tills an 
attractive option for commercial software products. NeoAccess is 
used in the latest versions of Netscape Communicator, America 
Online 3-0 and NetObjeexs Fusion. 

For more information, check out the NeoAccess 
Technical Overview. The overview, plus source code and 
executables for the demo programs, are available on the 
NeoLogic web site. 


LIRLs 

• Neologic, Inc. Web Site - <http://www.neoloqiccomx 

• NeoAccess Technical Overview - 

<http://wvw,neologicxom/archoviw.h^ 

• NeoFontm Mailing List, Subscribe or view archived messages 
at - <http://dio jyris,net/cgi-bin/lyris.pl?site=neologic&page= list&list= 
neoforum>, 
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OpenBase 


A Solid Database 
Framework for Rhapsody 


iNTHODUCnON 

OpenBase is a solid database 
framework which will address your data 
handling requirements for Rhapsody, Like 
Rhapsody, OpenBase's foundation is with 
NeXlYTER It has evolved through the 
years to provide a mature envirrinment for 
stand alone users as well as over 
distributed networks, For the developer, 
OpenBase lias a rich set of application 
APIs that incorporate the C and Objcctive- 
C languages. Regardless of develofiers 
programming background Mac OS or 
NeX'l'S'rFP/OpenStep, the OpenBase API 
framework allows cjuick development of 
full scale database applications. 

OVF-RVIFW 

This article will illustrate: 

• Steps to build SimpieToof an applicaLion 
lliat queries a "Movie” database, sliow 
just liow simple is writing an OpenBase 
database application. 

• Help Desk, an application using 
OpenBaseAdvancedAPI to address 
multi-tiered database interaction over 
local area networks. 

• OpenBase Manager, OpenBase's data 
management and interaaive tool 


SimpleTool 

SimpleTool demonstrates interaction with a relational 
database interaction without using the tedious programming 
overhead common with databases. 

Using C or Objective-C is the simplest way to access 
OpenBase, SimpleTool will retrieve from the database the movies 
and the revenue from the producing studios. Listing 1 illustrates 
the OpenBase API framework. A disaission follows. 


Listing 1; SimpleTool_[nain.m 

^import <Foundatlon/Founda tIon,h> 

^Import <OpeiiBaseAFl /OpetiHaso. h> 

int main (int arf^c, const char ^argvlj) 

I 

NSAutoreleasePool 'pool - [[KSAutoreleaaGPool alloc] Init]; 
int returnCodG: 

OpenBase 'connection = ob_newConnection(): 

//variables lo hold values 
char movieTitlef256]: 
char studloNaine[2S6]: 
lon^ revenue: 

if (lob_connectToDatabase 

Cconaectioiit ’'Movie", frreturnCode)) 

I 

printf {, ob_connectErrorHeBsafie(connection) 1; 
return -1; 

I 


ob^oaJ^eCommand(connec tion,“selec t tO.TITLE, tO.REVENUE, 
tl,KAME from MOVIE tO, STUDIO tl where 
tO,STUDIO_ID - tl.STUDIQ_ID order by tO,REVENUE DESC"): 

If (Iob_GxecuteCommand(connectlon)) 

I 

printf ("EREOR - S!s\n",ob serverMesBage (connection) h 
ob_lnvalldate(connect ion); 
return ’1; 

J 

ob_biTidStrlng(coniiGction, aovieTitle} ; 
ob_bindLong(connection. ^revenue)j 
ob_bindString(connection, atudloName)| 


Gene Backlin <gbacklm@Mari2ack.com> has been programming since 1978, and is owner and principal coasukani of 
MariZack Consulting, formed in 1991 with one purpose — to help. He has been helping clients such as IBM, McDonnell 
Douglas, Waste Management Inc., the U.S. Environmental Protection Agency, AT&T, Ameritech, Discover Card, Rockwell 
International, Bank of America and Nations Bank. He also helps local universities in ihe area of education and is author of the 
book "Developing NeXTSTEP Applications'’ ISBN published by SAM’s Ihjblishing. 
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Onyx Tecbndl 6 ^,Inc 



Spotlight Memory 
Debugger 

Spotlight is the fu^t automatic memory 
clcbujgcr for the Macintosh, Instantly 
detect invalid memory accesses, memory leaks, had 
toolix)x parameter, stack overwrites, memory relo¬ 
cation problems, and more. Spotlight cm find prob¬ 
lems in seconds that might take you a week to fix by 
hand, 

SfTorlight uses your XSYM file to automaticilly 
patch your PowerPC native application, Wlien 
Spotlight deteas an error it brings up the exact 
source code line where the error ocetirred along 
with stack crawls, memory view, and program vari¬ 
able usage information. 

No need to change your source code. No need 
to recompile. No learning curve whatsoever 

Spotlight’s Object Code Replacement instrumen¬ 
tation inspct:ts each PowerPC processor memory 
read and write instruction in your code as it is run. 
Spotlight detects faulty memor^^ reads and ™tes 
that ttccur between blocks, in released bloc'ks, 
across multiple blocks, and outside of your heap. 


I NEW I 


VERSION 




Features 

m Stops pur program on exact 
source code line where a bad 
memory write occurs 
m Complete leak reixining witli 
source code stack trace show¬ 
ing point of allocation 
m Fully validates parameters CO 
over 400 Mac toollx)x API 
calls. 

■ Works on all heap allocations 
Mac Toolbox, C 'malioc', 

C + 4- new and delete. 

■ Sup[}oiis any language that 
produces an MPW or 
Metrowerks XSYM file, 

m Full logging and ignore (afiabilities 
m API for fine tuned control 
m Purchase includes one par subscription to 
dowmioadabie updates 
m 30 day money back guarantee 

■ Available for secure elecironic purcltase now 
at our web site 


Mitdniosb or Mac QS-ajmpaiibie compuier tM a FK'6(}1 or 
greater processor: RAM n^urmients imy depetldir^{ on tar- 
applicatior} si^; 2 MB bard disk space: Systefn 7 5 tir iater; 
iMeinneerksor MFW corr^)attbie XSi'M spnkMcfiie 

Download free demo at http;//www-.onyx-tech.com/ 

$199.00 

TEL (W1)79^7H01 E-MAIL )istef£Ciinyi-lHJ).tiiin 

FAX (94l)79>5901 URL lilliJ://www,t]iiyx-cech.ai!in/ 


while {ob_tiextKow(ccn:inectiQii)) 

\ 

pi:intf{‘'%s made $%Id for %s. Vn“ .movieTitle* revenue, 
studioName) ; 

1 

ob_jnva 1 IdaLe(ctinneoLion) : 

[pool release]: 
exit(O) : 
return 0: 
i 

Main begins by establishing a connection to the datal^ase, if 
a connection was not made, print the offending message 
returned from the conneaion object and exit. Using the 
ob_connectToDatabase() function, establish a connection to the 
database with the database name, hostname, logon id and 
pa.ssword. Note the argument The database connection is 
made directly to die local machine on a standalone computer, 
but will poll all hosts on a local area network. This is an 
example of OpenBase’s scaieability, 

int returnCode; 

OpenBase * connection - ob_newCotinectioti{) i 

if (!ob^conneetToDatabase(connection, "Movie'*, 
iceturnCode)) 

I 

printf C"Is\ ti" . ob^connectErrocMessage (connection)); 
return -1: 


After a successful connection has been established, the 
ob„makeCommand() function is used to send SQL statements. The 


TITLE and REVENUE data columns from the MOVIE tabic as well 
as the associated studio NAME from the Si'UDlO table are 
retrieved. The SQL statements are now buffered for later 
execution by the database server. 

ob,,.inak6Coittmaiid(cDnnection,"select tO.TITLE, tO.REVENUE. 
tl.NAME from MOVIE tO. STUbTO tl where t0,STUDT0_ID = 
tl.STimiO.ID order by tO.REVENUE DESC")j 

The ob_executeCommand() passes the buffered SQL 
statements to the database server and returns TRUE for suc:cessful 
and FALSE for failed execution, 

if ( \ ob_e3cecuteCommand (connection)) 

I 

printf ("ERROR - %fl\ii'', ob_ficrverMciSfl£igo (cornec tloii)); 
ob_f nvalldatetconnectlon): 
rnturn -1: 


’Hie ob_bindString() and ob^bindLongO functions, bind die 
resulting data columns from the database^ to the receiving 
program variables, SimpicTool hinds the variables movieTiile, 
revenue and studioName respective to the order of tiie initial 
SELECT statement. 

ob_bindStJ:lng(connection. niovieTitle): 
ob_bindLong(connection. Srevenne); 
ob_bindString(connection, studioName): 
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Macintosh 
Development News ^ 


The site has all the current 
breaking news in the 
development community 
and even archives past 
news pieces. 


* 


Search the Site 


Search and find that 
article, news piece or 
source code you're 
looking for via the new 
Phantom search engine 
courtesy of Maxum. 


Article Archives 


These archives have 
thousands of pages of 
content in them from the 
histories of MacTech, 
MacTutor, develop, and 
Frameworks magazines. 


develop 


The entire history of 
develop, Apple's award 
winning technical journal. 
That is 29 issues from 
1990-1997. 
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ob_nextRow() increments through the result rows and 
retrieves the data* FALSE is returned when all daUi is prcxiessed* 

¥hi le t ob_iiextRow (c onne c 11 on)) 

* 

|irlntf{"Vs Eadn $%ld for tin An" .movieTitle. revenue* 
RtudloNeme); 

1 

Main ends with a call to terminate the connection to the 
database server. 

ob_invalidate(c o nne c tion); 

Heip Desk 

Help Desk, addrcs,'vt!s multi-tiered database requirements by 
directly connecting to the user interface through the 
OpenBaseAdvancedAPl as seen in Figure 1. 



Figure L Help i)esk Manager. 

Designing the Interface 

The Apple supplied tool Interface Builder Is used to de^sign 
the user interface. Infbrnruition on Interface Builder is detailed al 
<http://devworld.apple.coni/techinfo/techdocs/rhapsody/appie.coni>. Sec 
Figure 2 for a screen shot of a connection being performed 
using Interface Builder* 



Figure Z Making the interface Builder Object Conmctkm. 


Managing the Interface and Database Relatianships 

Two FormManagers and one RetidTablcManager are created. 
The first ForniManager lists customer questions and the other 
displays who asked the question* 'fhe ReadTableManager 
manages a picklisi of information. 

= [ [ReadTableHanager alloc] initls 
formManager " [ [FomiHanager alloc] Itiit] i 
contactsFormHanager ^ [iForinManager alloc] init]: 


To set the key attribute and table, each object must be initialized* 

[tableKanager aetKeyAttribiLte:@"EUppoct ,_rovid"l : 
[tablcManagor sitlTabloNanifliS®''support'll ; 

IforinManager setKeyAtti:ibtita:#"uiippori ._rowld“l ; 
iforniHanager satTableName:*®'*support"] * 

Ic ont a c t sF 0 rmMa na ge r s e tKayAtt r1b uta:^"c onta ct s. _c owid"J * 
[conr.actsFormManaget: satTableName ;t"contacts “ 1; 


Connect the interface objects; tableManager, formManager 
and contacLsFormManager to the database* 

[tableManager setConneeIIon:connectlon]; 

LformManager setConnectionreannneLion]: 

IcontattsFariisManager setConnectioni connection]: 


Set specific query ordering. In this example “ASC” is ascending. 

[tableManager setOrderByORDER BY 
support .sbortQucnrloii ASC"] ; 


Bind the screen objects to the daiatxise columns. 

jfdafina FIELD(outlet) LOntletManager newForOutlet:outietJ 
#defliie TEXT(outlet) [OutletTextHanager nevFotOutlet:outletJ 

#t1efino POPUP (out let) [OutletFopUpKanager \ 
newForOii11 et:out let] 

t t o rmMana ge t addOut le t:F1EL D(a bo r t Que a t io n) 

vithCoIunnNaiite suppo ct * shortQuestioti* j; 

[formManager add0utlet:FI£tiCproduct] 

withColumnUaMe support,p roduct"1; 

[ To r tiiMa na ge r a d d Qi 11 1 e t; TEXT (t ex tQue a tlon} 
wi LhCol umn Manic: gn pport .question"!; 

[foraiMimagcr addOu l leL:TEXT(LexiAnswer) 
witbColiminNaiiiG: suppor t * aiigwer"! ; 

IforMHanager addOutiet:FIELD(dateCreated) 

withColumnName;#"support.dateCreated"]: 

[fcirinHanager addOutlet: POPUP (answered) 

tf 1 thCol umnName support .answered"! ; 

vSet Up the Contacts Fomi to be a target of the FormManager. 

[contactsForroManager addOutlet; FIELD (firstname) 
withColtmiiiHaMe:©"contacts.firstname"]; 

[contactsFormManager addOvitl at: FIELD (laetname) 
wl ibCol umrMaitte: ©"contactB . lastnaine " 1; 

[contactsFonnMnnager addOii L1 oI; FTKT.D(cma 11} 
wltbColnmiiName;©"contacts .email "11 


Add each column to initialize the table. 

[tableHanager addColumn:@"support.product” 
tltle:©”Producf 1: 

[t ableMnnager addColimn:©"support.answered" 
ti tie:©"Answered"! : 

tlciblcManager 3 ddColmiin:©".siipport.flhartQnestion" 
title ;@"Sumjaary”J; 
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Inilializc Lhc windowTabieVicw objea, to dispJay the query results, 

[tablcManager setTablfiViewiwindowTsbleVievl : 


Establishing Database Relationships 

Ihe formManager will display related details when a 
selection is made in the UibleManager. To aca>nip!isli this, a 
target relalit>aship must be made between the tableManager 
and formManager, 

ftableManager addTarget:fortoHanager 
vithValue:support._rowid"]; 


Ihe contactsFormManager displays the contacts through ihe 
contacTs^id key, 

[formHanager aJdOuilet:contactsForjitManager 
withColurmNane: support, coutacts_id“ ] : 

The formManager seLs the SQL '"WHERE” ct>mitrainLs as well as 
sabqueries, 

[tableManager fetchData:ffornManager whereConstraintsI); 


Insulation from Direct SQL 

OpenBase’s OpenBaseAdvancedARl, completely insulates 
you from SQL commands like SEARCH, RESET, SAVE and 
DELETE, by the following methods. 

- (void)findActJon:aauder 
I 

[tableManager fetchllata: [formMaTiagcr wtiereConin raini r]] : 

I 

- Cvoid) resetActlon: sender 
I 

ftableManager resetAction:self! i 

1 

- (void)saveAction:sender 
1 

FformHanager saveChangesIr 

1 

(voidIdclctcAction:sender 

\ 

[tableManager deleteActlon:seir]r 

I 


The OpenBase Manager 

In addition to the developer API frameworks, OpenBase like 
Rhapsody^ designed graphical tools to simplify tasks. OpenBase 
Manager simplifies the following: 

• Managing Database servers across local area networks 

• Viewing Databases 

• Editing Database schemas 

• Managing Database security 


OpenBase Interactive Database Toolset 

The following screen shots display OpenBase's rich set of tools. 



Manager fi.I TCPIP 


xoaiparty .; nairriBb:: 

^ -. ; . 

: ::::: ^ 

I ^^. .blnirran ■. 

; : hanaafv ! 


Start Database 
Stop Dtibba^ 

Yiewing Databases 

Admiithtratiofi 

Chatigt !%nie aitd 
Hf»sf 

Create Database 
Duplicate Database 
Delete Database 


Figure i OfXfnBa'ie Datah£isv Afart^ger. 



figure 4 User Acimmistmtion. 
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Figure 6. Dalahase Table Aclministraiion. 


User 0)mment>s 

Sirius Connections, a leading provider of inrernet services 
for the San Francisco area, uses OpenBase for hilling and 
maintaining historical records on 15,000 customers. “Our whole 
operaticm is built on OpcnBase teclmology, “ says Andreas 
GlcK:kcr, CEO of Sirius Connections, “Automating our business 
on OpenBase has made all the difference. Ti has given us the 
CO mpet itive adva n Lage." 

“One of our programmers wrote a system using the 
OpenBase API in less than a day. Doing the same thing using 
Oracle OCI’s took more than three," says Kevin Ford, 
President of Computer Active located in Ontario Canada, 
“OpenBase demonstrates a level of quality and robustness 
rarely seen in the software work!/ 

Roben 1„ Peek, f< Hinder of the Peek Financial Croup, says, 
“We have adopted OpenBase as an enterprise wide solution for 
our firm. We have found it to be an industrial strength dataljase 
with excellent supporL” 

Contact Information 

OpenBase supports ODBC for Mac: OS and Windows and 
has a native JDBC driver. For furtlier information about 
OpenBase and how you can get a FREE single-user nintime, 
you can contact: 


OpenBase International, Ltd 

58 Greenfield Road 
Fnincestown, NH 03043 
Tel: 603-5474^404 — Fax: 603-547-2423 
e-mail: <info@openbase.com> 
internet: <http://www.openbase.com> 


Hi 


Stop reading hex, 


Save time with 
Quadrivio Generai Edit, 
the fast way to edit data fiies 


□= mr/TLED 


(I) 


1 


Define your file format 

• Easy, familiar C-like statements. 

^ Complex formats handled by powerful syntax. 

• Input is checked and compiled as you type. 

View, edit, or analyze your data. 

• Edit data directly in window. 

• Automatically check values, at your option. 

• File can be larger than RAM. 

Multiple uses: 

• Modify Finder Info and file parameters. 

• Also edit data in application heaps, 

memory handles, and parameter RAM. 

■ View entire disk volumes. 


Quadrivio General Edit 

ADVANTAGES 

✓ Quick insight into data structure contents. 

✓ Easier than studying MPyiTs dumpfiile output. 

✓ Faster debugging with clear display of data. 

✓ Saves coding time with direct data editing. 


NEW 


On-line version $195 


Stort using General Edit jusi 30 minutes from now. 
Visit our web site. See, Learn, and Download. 


http://www.quadrivio.com 


Quadrivio Corporation info@quadrivio.com 
T563 Solano Avenue #360 Berkeley, CA 94707 (510)524-3246 
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Neil Ticktin, MacTech Publisher 


If you are an old-titne Mac 
programmer like me, cihances are you 
remember the original Macintosh 
teclinical journal, then called MacTutor. 
Hemember the MoiiseHole? Axtec C? light 
speed Pascal? MacTuior filled in the 
technical holes for a lot of aspiring 
Macintosh developers. If 1 recall correctly, 
it was at August MacWorid when I first 
met Neil Ticktin. Word was tiiat MacTutor 
was having some difficulties, and NeH 
was going to rake over the magazine lo 
see if he could make a go of it. We lalked 
alniul my doing a regular column for 
l>eginners, starting with the January 1992 
Issue of Mac fiitor 

Now it is more than six years later. 
Titc magazine changed names to 
MacTech, grew a new' look and feel, has 
been through a number of personnel 
cfianges frt>ni top to lx)ttom, added a 
mail order catalog, absorbed Apple's 
develop magazine, and helper! spawn 
MacWorUVs Deveioper Ccmtral. It has 
been a wild ride. 

At this past January MacWorkl Neil 
and 1 had some long talks about the state 
of Mac development imd the direction 
Apple was taking the Mac OS. Make no 
mistake here, Neil Ls no hard*core 
developer But he has a unit|ue 
perspective on the state of the Mac that 1 
thought you might find interesting and 
valuable. So, without ftirlher adr>... 


Dave: How has Apple's shrinking market share affected 
MacTech Magazine? 

Neil: The interesting thing alxml MacTccli Magazine is that it 

largeLs devclo[^rs, not users, and, as a result, tends to be a 
good fijRire indicator. Kor example, MacTech had less readers 
in 199^-6 which preceded Apple's deiJine. MacTech, over the 
past year/year aotl lialf, has actually had growing readership. 
And, in addition to that, we launched MacTech Japan which 
has done very well. vSt:), we're pleaserl with how things are 
going — and we think that 199H will Ik* a much better year 
for developers than 1997 was. 

1Tie interesting thing about market share is that people are 
generally talking alKnii sales of compiaers, not installed base. 
To most developers, installed base is w'hat is important. And, 
if you look at Macs in current use as a percentage of all 
personal computers, you probably w^ould sec market share 
ckxser to And the (x:acntage is pr(>l>abiy latger if you 
talk alxjut active Mac users compared to die overall number 
of active personal computer users. Now, as a developer, do 
you care how many machines Apfjle sells? Or do you really 
care alioul Imw many customers can liuy your product? 

llie disparity caused liy sales markei share and installed base 
market share comes down 10 two things. First, in most cases, 
Macs are lietter built and will last longer than their WinTel 
counterpart. Second. Apple has done a pretty gcxxl job of 
ba£:kwards compaLibiliLy which translates into preserving dieir 
customers' investments. This may m>t be the most profitable 
thing for Apple, but it does wonders for the cusifjmcrs. It's 
unfortunate, but OS and hardware vendors make more 
money if they liuiid products that l>ecome olisolete quickly. 
This is not what Apple or the Macintash are about. 
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Dave: I was surprised with the lack of Rhapsody 
presence at January MacWorldL While there were some 
Rhapsody apps being shown at Developer Central, there 
was no mention of Rhapsody at all in Steve Job’s 
keynote. Where do you see Rhapsody going from here? 

NeiL For a while there, A[>ple was into fuelling the future. 
Apple seems to have learned the lessons of the past, and 
today, Apple focuses on selling what it can deliver right 
now. In addition, with Mac OS 8, Apple realized that the 
Mac OS still has legs. These two things, 1 liielieve, are the 
main reasons behind Apple's down playing of Rhapsody 
(or maybe it was just up-playing the Mac OS) at Macworld 
San Francisco. 

Also, 1 think that you will see some blurring of the benefits 
of future Mac OS's in comparison with Rhapsody. Apple 
has eluded to bringing more modern OS features to the 
Mac OS — whether this comes from Copland work or 
Rhapsody work being integrated into tlie Mac OS, weVc 
not seen yet — but it looks to be coming* 

As a Mae OS or even OPF.NSTFP cieveloper, you should 
watch die Mac OS efforts. It may be the ease that the feature 
you really needed gets incorporated into the Mac OS — and 
today, that has a lot bigger set of eustomers. 

Rhapsody is coming along, and there is developer support 
of it. There are a number of tools vendors already 
supponing Rhapsody: Metiowerks, AAA^ SNAP, TipTop, 
OpenBase, etc... And, that’s for an OS that has no real 
market today, When Rliapsody is ready, 1 would expect 
Apple to take the approach of easing it In with as little 
cannibalization of the Mac OS as possible* Hopefully, they 
will he able to expand the market for developers, not just 
replace what we already have. That means that youll see 
special aiLenlion paid first to those users who have tlic 
greatest need fur features only found in Rliapsody, 

As a Rliapsody developer, you should pay attention to what 
Apple Ls targeting first If you don't inaich your efforts to 
where the potential customers will be, you will probably 
have a problem. 

Dave: How do you see the economics of selling into tlie 
Mac OS market in 98? 

Neil; Interesting thing about Mac OS 8 — ifs been selling 
well In faa, according to a November 97 Soffrends repon, 
Apple look the top market share posiuon in August 97 with 
35-1% of units sold, compared to Windows 95 at 27.8%. Tltis 
was the first time that any Mac title attained the number one 
ranking. Read this again — the Mac OS outsold Windows 95. 
Now yes, diis is a brand new OS vs. a 2 year old OS, hut it is 
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a good indicator that the Mac is a lot healthier than the media 
would lead you to believe. 

Another interesting point to think about is that Microsoft 
operating systems certainly have some 90% of the installed 
base. But realize that this is divided between DOS, Windows 
3.1, Windows 95 and Windows NT There are some pieces of 
software tliat run on both 95 and NT, but a lot of software has 
separate veniions for each of these OS's, or maybe just 
doesn't mn on them* Tlie NT market sliare is far less than die 
Mac OS, And, wlien I saw numl:»ers last summer, only 19% of 
the market had upgraded to Windows 95 — nearly two years 
after it s release, and it's market share was n<jl even doyl)le 
the Mac OS installed based at die time. 

A couple of years ago, we were kxiking at the business 
prospetis for Mac devclo|x:r.s. Wliat wc found is that yes, 
obviously, the Mac has a smaller market size. But, 
interestingly, when you look at the Windows market, factor 
in the disproportionately higher marketing, lech suiiport, QA, 
deveio[Dment, and otlier costs — the return on investment 
was liigher on the Mac than it was under Windows. Today, 
that return has evened out, but it still l(K>ks like die Mac OS 
develo[)ment is close to the reairn on investment that 
Windows development has. 
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And, all of this is during a time that has been hand for Apple. 
As of this writings 1998 is looking to be a much stronger year 
for Apple and the Mac. Apple just turned it’s first profit in a 
while (and remember, due to prior losses, Apple has tax free 
profits for a long time to come). A lot of shakeout has already 
happened, and some developers (like C^ady & Greene Inc.) 
reported that this last Macworld was one of their best shows 
ever! Now is the time of opportunity for Mac developers as 
the market starts to grow and prosper. 

Don't get me wrong, I don’t want to blindly support Apple or 
Macintosh — we just do things that make sense around here, 
and we make up our own minds. Win95 has certainly a lot 
more units out there. As a developer though, you need to 
make decisions based on what you know about what you can 
do — not what some reporter, finance person, or Wintel 
marketing person tells you. 1 can tell you from experience, 
there are a lot of people out there that are succeeding on the 
Macintosh^ and wouldn’t give it up. 

Dave: What kind of changes do you see coming down the 
pike with Develtjper Central? 

Neih As you know, MacTech and Apple created Developer 
Central together in January 1995. Today, now in our 4th year, 
Developer Central continues lo push the envelope — 
demonstrating not only tools for die Mac OS, but Rliapsody 
as well You may have noticed that in Macworld Expo's 
roundup, Developer Central was listed as one of the top 3 
successes of the show with about 45 technologies 
showcased, it represented some 10% of the exhibiting 
companies at the show. 

The cool thing about Developer Central this past January is 
that we are seeing some really neat things pushing the 
envelope, 'fake products like Resorcerer, which is getting 
support added disasseinliling code. Or, AAA+’s Joy which 
can be used to really learn a lot about Rhapsody 
development. This is just to name a couple of cool tools — 
there are a lot more, 

Dave: I thought it was interesting that you were asked to 
present at the Eddy awards at January MacWorM. Whal 
do you make of that? 

Neil: Over the past couple of years, the Mac community has 

come to realize how important developers are. This year, 
Macworld and MacTech magazines joined together to really 
give the developer community the level of support it 
deserved. Which tools received nomination status, let alone 
the winner status, was a hard decision. There were so many 
different products that are worthy. We’re very proud of the 
finalists and the winners. We're very pleased that Macworld 
Magazine agrees that developers are critical and tliat weVe 
joined togetlier to reward them. 


Dave: Whal options do you think are available to 
developers who are new to the Maciiiosh? How about 
long-time Mac developers? 

NeUi it all depends on what your goals are, wliat your project 
is about, and what market or functionality segment you are 
in. 1 know that you’ve heard this a million times tx:fore, liul 
just because the Windows market is l>iggcr, doesn’t mean that 
it’s l>etter. For example, if you are in an education or creative 
market, these are extremely strong for the Mac. likewise, if 
you don’t want to build a large oi^anization for marketing, 
QA, testing, tech support, etc... you may be very satisfied with 
a smaller Mac market with greater profit margins, less 
competition, and in general, a lot less hassle to bring your 
prixlucl lo market. 

What we hear today from long time Mac developers is that 
during the pa.st year or so, theyVe forced tliemscivcs to kx>k 
around at options l>eyond the Mac OS. Most kive looked first 
at Windows NT or Java. 

What theyVe concluded in many cases is that even with a 
lot of progress behind NT, it's still Windows. It still is not a 
pleasure to use. You still have to reinstall i^oftware, fiddle 
with drivers, .spend hours installing a hard drive, etc.,. It still 
is a poor interface by comparison to t!ie Mac. And the little 
voice inside their head, the artist side of them, says “1 don't 
like this as much as the Mac. Do 1 really want to work on 
.sometliing I don't like?” 

Java is another l>east entirely. There are a lot of really cool 
thing.s behind Java. And, the notion of ltos.s platfonn 
development is appealing. Unfortunately, even with a lot of 
progress here as well, it’s not quite ready for ^'prime time”. 
And, with all of the power srniggles over Java, people are 
concerned, developers are using Java — and are keeping 
an eye out for where's applicable. 

So, with those experiences, developers have been saying 
“Hmnim... mayl>e the Mac OS is not such a problem. Maybe 
1 just like working on it and the busine.ss proposition is ok 
and there is opportunities there. And, if Apple is able to 
deliver on Rhapsody, I can move my development iliere and 
then target Rhapsody, Rliapsody on Intel, Mac OS, Windows 
93 and Windows N*r all with one set of sources." So, Mac 
developers are kx)king for a liigli c|ualiiy enviromiient to 
work in, and lie successful at it — a combination of Mac OS, 
Java and Rhapsody seem to be the key for most. 

Dave: Can you contrast the US market with the Japanese 

market and offer some suggestions for developers who 
want to move into the Japanese market? 

NeiL First, let me say that Japan is a wonderful market. It’s a 
wide open Mac market that you need to explore. It is a long 
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term play, and you need Lo carefully look at your options. 
D(}n'l cxpccl to fty in, find a partnci; lly home and kivc tJic 
deal done in a week. It usually takes months to put 
something in place. 

Market share for Macintosh in Japan is rougiily double that of 
the U.S. for a country that has almost half as many people as 
the LIS. population, Apple sells al>cmt 25% of its units into 
Japan. And, unlike die proldcjns in the Ja[)ane.se PC market 
due to an economic downturn, the Mac market has been 
much stronger. 

Ja[:>an offers a ctanpletely different type of econoiny than we 
are used to in the U.S. For example, a copy of Madfech 
Magazine goes for IIS$5.85 on the newsstand. Tn Japan, 
MaeTcch Japan sells for ¥2500-Y2800 — rciughly equal to 
about IIS$20 or more. And, to give you an idea of the 
developer market, MacTech Japan has consistently sold w^ell. 
Similarly, c'ompanies like Meirowerks Japan fuive done 
exceptionally well in rliis market. 

The first sugge.stion that I can offer is lo CfO lo Japan, You 
need to learn a[)out the culture, and cx[)erience sometliing 
like a Macwoild. Lexjk at magazines on the newsstand, and 
visit shopping areas like Akihabni [we need to check the 
sfXiJling on diisl. Yoli will almost definitely need a Japanese 
partner to succeed. You won't be able lo jxjnetrate llie market 
without someone having a naiive understanding of what is 
going cm. You should talk to fellow developers and see who 
they have used. A [personal recommendation for a lcx:al 
partner is an excellent way to go, 

Dave: Any advice you'd like to offer to the Mae 
developer on the edge, considering moving to the 
Windows market? 

Neil: First of all, figure out which platform is the best way 

to deliver your product. If you are in education or creative, 
the Mac is the definite winner Rut, if you are doing legal 
or accounting software. Windows is prol>ably your better 
bet. WoiTy about creating great products for whatever 
platfonn and then sell the benefits of that product. 
Reiricm[)cr, on the inLcrnct, no one knows you're a Mac. 
8o, if you have something they definitely need “ who 
cares what machine it runs on? Or use the Mac as your 
place to <io your primary development, and then deliver 
on multiple platforms if that makes sense for you. It all 
comes down to what you want, and what you know about 
where your product can succeerl, El 
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TECHNOLOGIES 


by Mark Holtz 


Using Apple Information Access Toolkit 


Applets new indexing 
technology provides 
poutetfiil ways to search 
and retrieve your data, 
regardless of how ifs stored 


Exa(tly Wiiat is AIAT, and What Can 
It Do For You? 

'llie Apple Information Access Toolkit 
(MAT) is a lil)niry of roiiiines designed to 
distill, index, and query eollections of 
textual data. Tlie elegance of the 
technology stems from it’s ct)mplete 
independence from the actual data source 
it is indexing. It am used in a fully- 
interfaced, stand-alone application, f>r in a 
memory-constrained plug-in. You can feed 
it eveiytliing from your next-generation 
database to a catalog of your Conipatt Disc 
collection. Best of all, rumor has it that 
MAT will be a pan of Rhapsody, so your 
hard m^rk now will pay off in the future, 

Sounds great? How do I use it? 

If you haven't guessed by now, yoLihe 
going to have to get your hands dirty and 
write some code. MAT provides a set of 
C++ objects diat can Ix.^ sub<lassc+i to 
provide the desired functionality. Strange 
runtime quirks notwithstanding, the 
overall process is aclualiy easier tlian it 
may first appear. In a recent development 


projea, I created an MAT-based pliigdn diat indexed and 
{[ueried data from a 3rd party database in less than two days. 
This article will focus on that development project and some of 
the lessons I learned. I'he most iniponanr lesson was that MAT 
will do a lot of the work for you, but you have to tell it exactly 
what you want. 

AIAT: A Tf.chnotx>gy Overview 

Upr)n unwrapping die AIAT package, you will find a nice, 
clean set of components to speed you on your way, 
Documentation is provided in Adobe PDF format, and is 
relatively comprehensive in scope, but occasionally Lacks tlie 
necessary depth to help you fully understand a particular objea. 
Next, a set of 68K and PowerPC libraries for Metrow^erks' 
CodeWarrior 11 and Pro 1. Where there are libraries, dicre are 
also headers, MATs headers comprise wliai I consider to be the 
missing portions of die documentation. Not only are they slightly 
more current than the documentation, but also provide the 
necessary implementation details one needs to avoid MacsBug. 
The C++ classes in AIAT arc robust, but you only need to deal 
with a small number of meihcxls to create a working application. 
Finally, there are two example applicTitions, one that indexes files 
in a folder and ancidier that leLs you query against the generated 
indices. They are fairly complete in their coverage of basic AIAT 
concepts from a diem perspective, but give only maiginal insiglii 
into how new data sources can be interfaced to AIAT. 

The AIAT documentation stresses thorough design and 
analysis. Having a clear picture of which objects deal with which 
data and where that tlata goes will make your ctxiing efforts 
mudi more cnjoyaldc. Now that you've done that, let’s get down 
to architecture. AlAF functionality is broken up into six major 
categories: Indax, Analysis, Corpus, Accessor, Storage, and 
Sh^mhk. Tile Index das,ses handle creation and maintenance of 
keyword lisLs and document references. Ihe Analysis classes are 
responsible for generating and filtering keywords based on 
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various criteria. ITie Corpus cliLsses are an absiraction layer for 
obtaining data from various sources. The Accessor classes 
provide query and statistical information from indices. Finally, 
the Storage and Storable classes provide a flexible mectianlsm fur 
the storage and retrieval of arbitrary secs of data.A quick browse 
through the (leaders shows an abstract C++ object for each of 
these categories, such as the class lACorpus. 

You will also find various utility functioas, including a set of 
memory management calls. You can substitute your own 
allocator and deallocator routines easily, and AIAT will happily 
use them for block and object allocations, Tliere arc a few rol^ust 
concrete subclasses provided, which you can use directly or 
subclass to enhance their functionality. The HFSCorpus and 
HFSTextFolderCorpus classes allow MAT to index lx )1 lections of 
text documents. iTie EnglishAnalysis class allows AIAT to filter 
document keywords wiUt arlntrary stop-word and word-stem 
lists. AIAT makes use of its own exception handling mechanism, 
based on C++ exceptions with a few additions. A little 
exploration thn>ugh all the componcnls of the AIAT distribution 
Is Lime well spent, as there are a number of classes and functions 
not specifically called out in the documentation. 

The Task M' Hand 

1 was first introduced to AlA'l' early in 1997 during a 
conversation with a good friend of mine. He suggested that I look 
into it as a possil)le full-text indexing solution for a Mac-based 
Web site we were creating. As the months passed, we settled on 
Purity Software's WebSiphon product as the l)ac:k-end scripting 
engine for this Wcf> site. WebSiphon includes a fast flat-file 
datal)ase called Verona. It had l^asic search capabilities, but they 
were not robust enough to support the kind of ranked cjucries 
you*d find on more pi.>werful FulTTexi Indexing Systems. 
WebSiphon's language Is extensible via Code Fragjnent libraries, 
so the idea for an AIAT library for WebSiphon became an 
appealing solution. We could collect information from a variety of 
sources with WebSiphon, slom it in Verona, index it using AIAT, 
and then query* against that data using WebSiphon scripts. Since 
AIAT is simply a set of libraries with little runtime enviromncnl 
dependency, the task was not daunting, Tlie project was distilled 
into a few discTCte tasks: Create the scripting interface for 
WebSiphon, write the C++ code to interface with the MAT 
accessor and index classes, write the C++ code for interfacing 
AIAT to VCTOna, and in;ike the entire thing work in a multi- 
tlireaded environment. Each phase of the project involved one of 
AiA'Fs major areas of functionality, so 1 was able to f(x:us on one 
set of ccmcepLs at a time, a tril)ute to AiATs nitxiular design. 

Habeas Corpus 

The first task lo tackle was to provide AIAT widi an interface 
to Verona so it could access the reams of data our sire would 
produce. This involved getting familiar with AIATs Qirpu.s 
classes. In AIAT', the Corpus provides access to a colieciion of 
"diKumcnts" and die data they contain. The lADoc class is the 
abstract representation for these documents, and it consisLs of a 
name for the doaiment and access methtxls for die data. In diLs 
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case, our documents were recoixls in tlie Verona database, and 
the data would be accessed via an API to the Verona application 
instead of reading it directly from a file. After a little bit of work 
with the Code Fragment Manager, 1 had a functional C++ interface 
to Verona, so it was time to tell AlAT how to deal witli it. First, I 
created the CVeronaCorpus class, and defined the two pure virtual 
methods required to make it work: GetProLoDtx: and GetDocText, 

listing 1; CVeronaCorpii5>h _ 

CVeronaCorpus 

Class ddiniUoo and tvquirtd meihods for our Corpus inierfett to a Verona database, 

class CVeronaCorpus : public lACorpus 

I 

public; 

CVeronaCorpus(CVeronaGlue* inVeronaCine. 

const char* inDBHame); 
virtual "'CVeronaCorpus (); 

vir tua1 lAD oc' G e tPro t oDo c C): 

virtual TADocText* GetDocText(const lADoc* doc) : 

virtual lADocIterator* GetDocIteratorO; 


I: " 

lADoc* CVeronaCorpus;:GetProtoDoc() 

[ 

return nev CVeronaDoc{this, 0); 

) 

lADouText^ CVaronaCorpus::GetDocText(const lACoc* doc) 
I 

return new CVeronaDocText(this. (CVeronaDoc*) doc): 


lAbocIterator* CVeronaCorpus::GetDocIterator() 

I 

return new GVeroiiaDocIterator(tbis): 

J 

Phew! That wasn’t so bad. GetProtoDoc() rciums a new 
CVeronaDoc object, and GetDocText() returns a new 
CVeronaDocText object. Bui what are these objects? CVeronaDoc is 
a subclass of lADoc, AIATs alisiraci representation of a document 
within a Corpus. CVeronaDocText is a subclass of lADocText, which 
is respfinsible for providing the actual text of the document to 
AIATs indexing functions. The diird meihod, which is not 
required by AIAT to make a valid Corpus mechanism, is 
GetDocIteratorO. The lADocIterator class is used to implement a 
Coq^us that consists of multiple documents, and for providing 
each of those documents to AIAT in a consistent, ordered fashitjn. 
You may notice as you peruse the AlAf doaimentation that many 
functions deal with lADoc's as a fundamental unit of data. It is up 
to the Corpus to determine what that unit of data is and how to 
reaim it to AIAT when ifs requested. Mere are the definitions of 
the other Corpus subclasses 1 created: 

Listing 2: CVero naC orpns-h fcont^d.) ___ 

CVeronaDoc, CWcronaDoctexi, CVeronaDoclnteraior 
for representing the various subHelements of CVeronaCorpus. 

class CVeronaDocIterator : public lABocIteratot 

I 

public: 

CVeronaBcjclterator{CVBronaCotpus* inCorpus) : 
virtual ''CVeronaDocIteratorO ; 


virtual lADoc’ GetNextDoc(): 
private: 

CVeronaCorpus* mCorpus: 
unsigned long mCurrentIndex: 

h 

class CVeronaDoc : public TADqc 
( 

public: 

CVeronaDoc(CVeronaCorpus * inCorpus, 
unsigned long InRecRef); 
virtual -'CVeronaDoc[) : 

lAStorable'DeepCopyC) const: 
lABlockSiaeStoreSiaeO const: 
void Store{lAOutputBlock* output) const: 

lAStorable*Restore(lAinputBlock* input) const: 

bool LessThan(const lAOrderedStorable* neighbor) const: 
bool Equal(conat lAOrderedStorahle* neighbor) const; 

virtual byte* GetNaffie(uint32 'length) const: 
unsigned longGetRecRef(void) f return mRecRef; ) 

protected: 

virtual void DeepCopying(const lAStorable* source); 
virtual void Restoring{lAlnputBlock* input, 

const lAStorable* proto): 


private: 

CVeronaCorpus* mCorpus; 
unsigned longMecRef; 

I: 

class CVeronaDocText : public lADocText 
I 

public: 

CVeronaDocText(CVeronaCorpus* inCorpus, 

CVeronaDoc* InDoc): 
virtual '“CVeronaDocText() : 

virtual uint3Z GetNextBuffer(byte* buffer, 

ulnt32 bufferLen): 

virtual lADocText* DeepCopyC) const: 
protected; 
private: 

CVeronaCorpus * mCo rpus: 

CVeronaDoc* mDoc : 
byte* inBuffer: 

unsigned longmAnitRead; 
unsigned longmBufSize; 

I: 

At this point, weVe got all the elements for our Corpus 
impiemenfation. However, it may still be unclear how these items 
work Logeiher. When AIAT receives a request to update a 
particular index, it starts a dialog with the Corpus object that is 
tied to that index. It starts by asking, “What sort of documents do 
you contain?'’ By calling GetProtoDoc(), the Corpus can supply 
AIAT with a ^‘sample" document. AJAT then asks for an object 
that can iterate through all the documents in the Corpus* 
collection. If one is available, it is returned via the 
GetDocIteratorO meihod. Since AIAT knows nothing about die 
particular data set it’s indexing, the Corpus needs to provide 
these mechanisms, if a document iterator is available (which is 
true in this case), AIAT begins asking the iterator for successive 
documents in the collection. 

AIAT makes two assumptions about documents that you must 
keep in mind. First, all documents in a particular Corpus aie of the 
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same type Ci.e, CVeronaDoc)^ and serand, that the order of the 
documents is always the same for a particular set of docyinents. The 
latter is important because MAT uses the document sequence for the 
indexing mechanism. Hence, the notion of a document being "Less 
tlian” anotlicr dcx:umcnt really has to do with it's order in this 
sequence. Be sure to be consistent for wliatever kind of data you’re 
delivering, and this should not be a problem. Getting back to the 
dialog, AIAT now has an lADoc it can work with. Tl starts by asking 
the clcxrumcnt for an lADocTexl oI>jecL tliat exmlains the document's 
data. In our example, the CVeror^DocText class knows how to access 
llic text in a Verona database record, so our CVeronaDcx; object hands 
a fresh CVerorxaDocText object baci to AIAT This object on access 
its parent CVeronaDoc objea, and uses that link to obtain the record 
number in the database that the CVeronaDoc represents. 

Finally, it is time for AIAT to get the text of the document, tt 
does this by calling CVeronaDocTexl’s GetNextBufferO methexJ. Tills 
method retiims the specified number of byres from the document. 
Note that rhe CVeronaDocText object must maintain its own 
infomiation atiout wliat data AIAT lias already ret]nested. Tt may help 
to tliiiilc of CVeronaDocText as a one-way stream of data tliat is read 
in chunks of arbiemry size. AlA'F will continue to call GetNextBuffer() 
until tlic rnciiiod returns zero, indicating the end of the data, 

AIAT will continue to call the iterator and resulting document 
and document text objects to obtain the complete set of data in the 
Corpus’ collection. The other methfxis of lADoc are used to 
detemiine how a particular document should be placed in the 
index. It is necessary to ovenide these in your subclasses so that 
they are meaningfiil to the data youTe representing. In my case, the 
LessThanO and EqualToO metliods compare d(K:umenLs based on 
tlieir specific Veromi index number. Also amongst tlie methods of 
lADoc you'll have to override are Store(), Restore() and DeepCopyO. 
Tliese methcxls handle convening the objea into a data stream, 
cieating an object based on a data stream, and making a complete 
and independent copy of an object, These functions are nicely 
explained in the AIAT documentation, except for the DeepCopytngO 
and RestoringO metliods, which ane ased to construct the 
superclasses of your document class in a DeepCopy or Restore 
situation. Tine only place these functions seem to be documented 
is witliin die header file of lADoc itself This may be a perfect time 
to go back and browse tlie AIAT lieaders again, 

Now we have a complete Corpus struaure for AIAT to 
handle Venina Databases, A bit of implementation here and 
tiiere, and we're ready to start indexing and querying tlic data. 
However^ before moving on to the next section, it is important 
to keep in mind that there is a lot of possible funaionaUty within 
the Corpus classes that I have not covered here. For instance, 
one can filter documents selectively witliin tlieir lADocIterator 
subclass, providing only the documents they want to AIAl’. As 
an example, the HFSTextFolderCorpus class filters out files that 
aren’t of type 'TEXT'. For tlie Verona interface, it was not 
necessary to implement a very complex Corpus interface, but be 
sure to explore the section fully and determine which features 
can help you in your application. 


MkLinu 


Microkernel Linux for the Power Macintosh 







MkLinux is a complete system^ based on Linux 2 and the 
Mach 3 microkemeL It includes development tools (gee, 
gdb, perf X11R6,3, and hundreds of other commands. 

MkLinux builds and runs most Intel-based Linux software. 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms. Visit Apple Computer's MkLinux web 
site {www.mklinux.apple.com) and Prime Time Freeware's 
web site (www.ptf.com) to find out more about MkLinux 1 

MacPerl: Power and Ease 

MacPerl is a robust and powerful port of Perl 5 to the Mac. 

It runs under the Finder and MFW, supports Apple Events 
and Toolbox calls, and is generally quite nifty! For details 
on MacPerl and associated products (book, CD, etc.), visit 
the MacPerl Pages (www.ptf.com/macperl). 


Prime Time Freeware 
370 Altair Way, #150 
Siannyvaie, CA 940S6 


info@ptf.com 
(408) 433-9662 
(408) 433-0727 fax 


Indexing and You 

The ultimate goal of AlAl’ is to generate an index of terms 
that can he used to satisfy queries about the database. AIAT 
provides two different indexing meclianisnis to accomplish tills 
goal. An Inverted index contains a list of terms and references to 
documents that contain the term. A Vector Index contains a list 
of documenLs and tlie terms that each document contains. These 
two types of indices can be used separately or together to satisfy 
various types of queries. In AIAT, the two types of indices are 
combined to create a Ranked Index, capable of providing ranked 
results to keyword, boolean, and example-document queries. For 
the purposes of tills project, we chose to use a Hanked index 
because we would tie searching our data In a variety of ways, 
and wanted to provide as many possible metlicxls as we could. 

'Fhe next task in our development project was to actually 
index the data using AIAT. 'This is accomplished by using the 
Index, Corpus, Storage, and Analysi.s classes in concert. The code 
is simple and straightforward, and the examples are an excellent 
place to start. Here’s a snippet of our indexing code, which is a 
slightly modified version of the example crxle: 

lATty 

[ 

tindex = iaDataSci\irce->CetIudex() : 

// 

// Makes calls to; 

// MakeHFSStoragcO, new CVemnaCorpusCdbName), 

// new SimpleAnalysisO. and new TnVecTndexO 
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tStoragf! - BiDataSoutce->GetStorage(): 

iStoriigc >Ini i ial i^et); 
tindcx->lnltiall3te(): 

tIndex‘>SetFluEhProg^essFn^ 

fiiCSTwinDSUpdatelhread:isFlusbUpdateFunc): 
t: Tnd ex - > Set F1 u shp r o gre ssFreq{10): 

tindex >Update(); 
tStprage >CoMnlt(); 

J 

lACatch (const lAExceptlon& exception) 
f 

: :Syf;Beep(0); 

WSAppendLog((char*) exception.What()) : 

} 

To create an Index, a tw otlier objects need to be cntrated. First, 
we need to store the Index data f«>mewheR-\ Tiiis Ls acmmplislied 
wid^ ilic lASioragc class and it's subclass, llPSStorage. AMF provides 
a builPin meciianism for creating disk-based lAStorage cjbjetts, ,so 
one call to MakeHFSStorageO takes cane t>f this task. Next, we need 
to establish a Corpiis to indc^x. Creating a new CVenonaCorpus object 
iliat jxjinLs to die desiied Verona database satisfies this requirement. 
'Ihe third part of the puzzle involves the methcxi ATAT should use to 
aaalyze the Oirpiis' data. The lAAriiilysLs class is used for tliis 
ofx.Tai!on, and die provided SinripleAnalysis() class was fine for our 
iinitiediaie needs. It eliniiruiies words under diree charatiers in 
lengdi, and cl^inges all renms it finds to lower case letters. Finally, we 
trreate the Index ofijeu iLself. Since we aie using the Inverted Vector 
index, a call to new InVeclndexO with tlie pointers to the .stomge, 
corpus, and analysis objects will suffice nicely. In this pjoject, IVe 
wrnp[>ed most of the specific creation into the Getlndex() iiielhcxl, 
and it lakes care of insUuUiating anything it may need. 

Initializing the index is our next task. Since weTe creating 
this index from scratch, we call the lnitialize() method of our 
lAlndex object. If we wanted to Ufxlaie an existing index, we 
would call the OpenO method instead. AIM* does support 
incremental updates of an index, but it requires you u> write 
some more logic in your Corpus classes. Due to limitations in 
ihe Verona database structure, we couldn't provide a clean 
method for determining when records had changed, so we 
didn't write the extra code to suppt>rt incremental updating. To 
prcjperly initialize a new index, you must first initialize the 
Storage, and then initialize the Index, using rheir re.spective 
InitializeO methods. The index is now cleared and of>en, 
awaiting new terms and data from the Cortxis, 

At this point, I will make quick mention of the various 
progress functions in MAT 'Fbey are available at m<j.sL places 
in the code where prenredures may take some time, .such as 
during indexing and long queries. These functions are well 
documented, and liehave exactly as you would expect. 
Following the progress fundion setup calls, we find a call to 
the UpdateO mediod of our index object. This sets the entire 
AIAT indexing mechanism into motion. A1A1' conducts the 
dialog with the Corpus that 1 outlined earlier, then takes tlie 
resulting data, processes it with the lAAnalysis object we 
provided, and stores the information in our Storage object. 
Once the process is complete, the data is flushed to the 
storage object via lAStorage::Commit{). 


One last thing to note in tfiis ccxlc snippet is the use of the 
lACatcfi and lATr>' macros. These expand to more standard C++ 
exceptions (or to other exception handling devices if C++ 
exceptions aren't available), AIAT uses the Try, Catch, Throw 
model for most all crrt>r rejxrrting. If anything goes wrong, such 
as an index couldn't be opened or you mn out of disk space, the 
program's execution would jump immediately to the lACatch 
block of code. In this example, we just l>eep and make a note in 
the lt)g, l>ut you wiU probably want to be more robust in your 
handling of errors. lf‘ you are unfamiliar with exception handling 
in general, T woiikl strongly recommend reading up on it before 
you start your AIAT-rehted project. 

live to Search^ Search to Live 

Whenever 1 develop a new piece of software, 1 like to set 
my sights on an end result that 1 can work towards, and when it 
happens. I’ll know^ IVe made it. !n this c’ase, the end result was 
to see a Web page that showed da Lai rase records ranked in 
relevance to my query siring. We've made it through interfacing 
a new data source to AIAT, and asking AIAT to index it for us. 
Now we need to make that index produce somctliing usefijl. 
AlA'r refers to a diKument that match a €|uery as a “hit”. 

Tt) genenite a list of liits in response to a query, we bring a 
new class, lAAccessor, into play alongside lAlndex and 
lAittonige. The Accessor class lies one or more indexes together 
and provides methods for posting a query and generating lists of 
hits. Ii also contains several small classes for describing hits, 
including the RankedHit class which contains a document 
reference and a percentile ranking, and the RankedQueiy^Doc 
class which can Lie used to formulate Query-by-Fxampie 
functions in AIAT. One of the more interesting features of the 
Accessor class is that it alk>ws you lo search several indices at the 
same itme, and the results can lx; a mix of documents from 
several different types of data sources, in our project, we support 
Verona databases. FileMaker databases, folders of text 
documents, and a few other types of data sources. With AIAT, we 
cm search any combination of data source types, and provide 
document references for each hit, along with specific infonnaiion 
about the data source that contain.s the [larticular document. 

The following snippet is from the code to generate a ranked 
hit list in response to a basic keyword query. 

Listing 3: Perform a ranked query on multiple data 
sources _ 

onkcdQiiery^fn 

char* tQuery “ ’^apple internet//query siring 
unsigned long count - 2^; //max * of Kits 

unsigned lung tcaullCkiunt " 
unsigned long i, tCti 
HFSDnc tDoc: 

RankedHit** results lAMallocArray(RankedHit*, count); 
inVeclndex** indices " TAMnllocArray(InVecIndex*, tCt); 

// lk:iup indices! 1 wi^h. list of indexes to isearch. 
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lATry 

[ 

for (i»0:i<tCt:i++) 
f 

ind tees[i]->Open C t rue)i 


CSl'winAccessor accessor (indices* tCt}; 

// MacroLmti;dj^ takes care of various init states ptoperi)’ 
accessor *HacroIiiiti3llieC) x 

resiiltComt " accessor ,RankedSearch( 

(unsigned chat*) tQuery, 
strlen{tQuery]* 

HULL* 0* 

results, count I 4. 
NIIT.L. 30, HULL)' 

DisplayResuits(sources, lGt* 

results* cesultCountJ* 

J 

lACatch (const lAExceptioni exception) 

{ 

char tErc[235j ; 

aprintf (tErr. ’‘Caught except ion: 

except loti.What 0 ): 
WSAppendLog(tKrr); 

for 

sources(iJ-)Close (): 

for (i-0:i<resiiltCount i i++) 

I 

delete resulLs[i]; 

J 

lAiTeeArrayCresults)■ 
lAFreeArray(sources): 
lAFreeArray(indices] r 
return noBrr; 


PrimeBase 

Prime Power Online 



High-performance Relational DBMS 


Now avaifable for Rhapsody 


Open System: ODBC, SQL, DAL Compliant 
Scninble tram 68K Mac lo [BM RSWMM) 

Proven Rcliubilily (formerly PJNK SQL) with instaHaiions^ 
aituind the world 

Crii9iS‘plaifarnii Rhapsody, MacOS* Windows 9S/N1’, Sun 
Solaris, Linux, 

Competitive Prices (lO-user server for Apple Hardware or 
PC only $S20) 

Highly Flexible Web Connectivity available 
FOf’ Adapter for OpenStep and Rhapsody 
Single-user Rifriliine available 


Developer Keys 

SNAP Innovation GmbH 

Tel: +49 (40) 30636400 Download Now! 

Fax: +49 (40) 30636333 www.primGbas 0 .com 
sales @ pri mebasexom 






Macintosh Programmers and Developers... 
PRODUCE and DUPLICATE quality disks 
Quickly and Economically with the “CLONE-IT” 


• Stand-Alone capability for performing its 
function as a CD-Duplicator* Prodiices absolute 
identical bIt-by-bit copies. 

• Easy hook-up to MAC systems. Automatic CD 
format detection and transfer to CD-R media. 

• Simple operation with the touch of a button. 


“CLONE-tT" 1 to 


CD-Recordables 


on SpkKiAG or 100 BlarhCOa 


Optics Storage Pte. Ltd. • USA 
1162 St. George Ave., Suite 150, Avenel, N.J. 07001-1263 
Tel: (732) 636-4466 Fax: (732) 750-1793 E-mail: optixsusa@aol.com 


Visit Our Web Site For Details On How To Receive A FREE CD Duplicator ■ www.optixs.com 


STARTING UNDER $1,000 

“The XEROX Machine for CDs” 


# 3 in 1 solution of having a CD-Duplicator* a 
Philips 2x/6x Writer (3 in the 1 to 3 Duplicator 
model), and a 12x CD-ROM in one unit. 
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In this snippet, we find il^ai the logic required to geaemtc 
hits with MAT IS very straightforward. We create arrays for our 
results and c^ur source indices using lAMallocArrayO, which is just 
a macro for AIATs allocator. We can use our own memory 
allocator if we want to, and can have AlAl' use it by setting one 
of AIATs public variables to the desired function. This is outlined 
in the documentation and the example code. It is important that 
you allocate and dealkK'ate AIAT classes and structures witli the 
same allocation code, or you may find youi^lf in trouble. 
However, AIAT subclasses all of its ol>jecis from one root class, 
lAObject, which has pnwisions within it to always allocate and 
deallocate using AIATs allocator funaions. Since you can set 
them CO whatever you want, AIAT will behave itself in whatever 
memory allocation environment you may have. 

Next, we find ourselves inside of another lATry Idock. 
‘fhis is because any AIAT calls from this point on may 
generate an exception, and we need to handle them 
appropriately. We run through the list of indices we want to 
search, and open them. The code for gathering the indices 
was removed for clarity, and it's up to you as to when and 
how you create the index objects for use in a search. 

The next few lines were* the most problematic in this project. 
Although it lcK)ked simple in the example application, I had 
overl(x>kcd an importani piece of information when 1 read the 
documentation. 'Ihe lAAccessor class requires a certain amount of 
information to be proyxrrly initialized, llie example apfdicalion 
tested for the presence of this information in the indexes storage, 
and if it wasn't there, it would create it. If it was there, it would 
simply load it up and ilie accessor would be ready to use, I 
missed this line of codL% and subsequently, all my searches would 
crash my machine in strange and wonderful ways. So, 1 created 
my own subclass of InVecAccessor that simply had this additional 
function to properly initialize an accessor in any situation. 

Listing 4: Proper initializatjon of an accessor regardless of 

previous state _ 

CSTNvinAccc\N<>r.tp.<:S“IwiiiAcccssor::Macit>InjtianKeO 

void CSTwinAcces^or^ :MacrciInitial iaeO 

i 

lAIndex** tTndices - r:Cetlndicos(): 

unsigned long i: 

if C llBlnitializationValld{)) 

StorelnitiallzatiotiO : 

for Ci"0!i<€etIndexCount0;i++) 

i 

lASttjrage* tSr.orage " tIndicasIlT>C«tStorage(); 
tStora|e->Cormitit (): 

} 

} 

else 

InitlallzeO: 

J 

This funaion uses IAAccessor::lslnitianzationVaIidO and 
IAA{x«ssor::Storelnitializatlon() to figure out the current state of tlie 
Accessor object and store it each of the indlce,s' Storage. Don’t 
foiget to c'all CommitO for each storage object to flush the changes. 


FoDowing the successful tnitializadoo of the accx.\ssor, we are 
ready to make our query. We ask the accessor object to remrn 
hiLs that match tQuery in the array of KankedHit object we 
created earlier, ResultCount is set to the number of actual results 
in the array, and 1 then call the DisplayResults function to display 
the resulting hits. The AIAT example code shows how to access 
the various items within a RankedHil object. Using the Index and 
Doc components of a Rankedllit, you can figure out which index 
a hit comes from, and thus what type of docyment it is. You can 
llien cast the lADoc* to an appR)priate lADoc subclass, and 
access additional information when presenting your results. 
Finally, we close up the indices and delete the RankedHit 
objects iliat the accessor aeated for us. With a few lAFreeArray() 
emails to go, we have completed our first query against our custom 
data sec using AIAT Tltat didn't hurt so much, did 

What to Do for an Encore 
It would be hard to encompass aU the facets of AIAT within 
the scope of a single article. With just a small amount of 
implementation, however, you can interface AlA'f to ju^ about 
anything. As with any technology, the best thing you can do is 
explore and try different things. (Isn’r that what the Macintosh is 
all abouL^) Once you're comfortable with the basic concepts in 
AIAT, diere are several concrete classes for you to try out, such 
as English Analysis (or Korean Analysis!), llie 1A Analysis class 
and its subclas.ses contain a great deal of interesting funaionality, 
and since they control which terms get generated by AIAT, they 
arc extremely important for en,suring that once youVe got your 
search engine running, the data it returns is actually useful. 

To echo the words of the AlA'f manual, be sure to spend a 
g(M)d amount of time understanding fx>th the AlA'l' architecture 
and the problem you’re actually trying to solve. Whatever may be 
lacking in the dot umentation alx)Ut implementation details is more 
than made up for by the walk-through examples diat are provided. 
Tic AIAT architecture is fairly ortliogonal, so once you understand 
die liehavior of one class of objects, you will find that the other 
classes follow suit. For llie power it provide.^, AIAT provides a lot 
of lx:ncfit Without a great deal of implementation effort. 

Resources 

1) Apple Developer CD Series, Tool Chcst/Mac OS 8 Edition, 
November 1997. 

2) <hrtp://wwwjesearch.apple.CDm/fesearch/techA/Twifi/>, 

3) Apple Developer World, 

4) Purity Software, Inc. at <http://www.purityxom/>. 


Interested in writing for the magazine? 
Contact us about a writer's kit at 

<mailto:editorial@mactechxom> 
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TOOLS OF 
THE TRADE 


hy William A. Gilbert, Ph.D. 


dtF/SQL — The Little Engine That Could 


slab makes there powerful 
SQL database engine 
available for anyone to 
use^ al little or no cost 


Introduction 

File formats, saving data, relating 
fields, multiple flies versus single file, 
backward compatibility.., this is the 
smiggle of ail programmers with each new 
project. One could always a third party 
database product such as FileMaker Pro or 
4D but tltat only increases the complexity 
of development, deployment, and support. 
Another alternative is to use a centralized 
daial)ase system such as Sybase, Oracle, or 
Microsoft SQL Server, hut often these 
stilutions go l:)eyond the scope of the 
project and introduce even more 
complexity and support problems. 

Often what is needed Is a small library 
which can store data, allow for die addition 
of new data definitions while being able to 
provide reasonable Irackward compatibility 
and to allow data protection from your 
compeUtton. Yet at tlie same time it must 
allow access by diase very special people — 
the clients and customers! 

Enter dtF/SQL, the little relational 
datalxisc engine that not only could but 
does achieve these goafs and many others. 
dtF/SQL, a relational database engine for 
Mac OS, Windows 95/NT, and several Unix 


platforms fr{>m sLAB <http://www.slab.Com/>, is provided as a small 
(403 Kbytes) linkable library which provides pure performanc'e and 
pure pleasure for any developer who requires data storage in a file. 

Having worked extensively with large scale SQL databases 1 
had always wanted a product such as dtF/SQL for the ’"little” 
projects. With this library linked directly into my application, I 
can store both data and program parameters, access that data 
using simple or complex queries, and extend the data formal by 
either adding additional fields to an existing table or by creating 
new tables. Using Finder file type and creator signature lags T can 
create double-clickable documenLs which launch the appropriate 
application under the Finder, as well as create custom icons for 
these docuincnLs. And the best part... ifs free to non-commercial 
users and has reasonable licensing for commercial use. Tliis Ls 
explained comprehensively at their web site. 

dlF/SQL implements an impressive set of ANSI SQL 
functionality. It also supports the BLOB data type which is an 
arbitrarily large binary stream of data such as an image or a 
numeric array of data values. Both local and remote retrieval is 
fast. This subjective statement is based on experience with other 
database engines as well as experience with reading and parsing 
other file formats. 


UiDLNCi CllMPl.EXrTY 

Our goal as programmers Ls to provide our clients and 
customets wilJi a prxxlua which performs bodi to spedfit:ations and 
expectations, but is also easy to use. Grady Booch has put it well: 
^The task of the software development team Is to engineer the 
illusion of .simplicity.’* This statement is paiticularty Uue for Macintosh 
applications, wiiere end users have come to expea an environment 
in which one copies the application with some documents from the 
distribution disk and just expects to double-click a ckxiiment and go. 
Using the dtF/SQL engine there are no extensions to load and 
configure, there is no resiaiiing the computer, and there is no 
performance overhead imposed by switching processes or diivers. 


William Gilbert <luip://www.inforniagen.com/cv/Gitbert.htinl> is a biochemist by training as wdl as a computer professional. 
He provides informatics solutions and scientific consulting to startup hiotechnology companies. He also holds a research 
professorship at the University of New Hampshire in the Department of Biochemistry and Molecular Biology. 
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Additionaily, there Ls no middleware to insUili with additional 
royalties. The lx)ttom line is tliat the developer is able to deploy self- 
contained double-clickahle daialxLsc applications and documents, 
runnable even directly from a CD-ROM. 

One Programmer’s experience 
I found the dtF/SQL API definitions and documentation, 
provided in PDF format, to be very readable. There are over 400 
pages which describe the installation, data types, high level API, 
and low level API. Each API has a usage example as w'cll as any 
restriction or limitation of the API. 

41ie Macintosh distribution comes with the application, 
dtF/Admin, which allows one to create and experiment with a 
database to see the effects of SQL queries, 'Fhis t<K>l is a great 
way for beginners to learn how to create database schema or test 
SQL queries on real data before cominitling these queries Lo 
source code. If you mess up die database, just throw it in the 
trash and stan over; you won't have an enmged database 
administrator lireatliing down your c'ubicle. The dlF/Admin 
application allows you to .save scripts so that the dataha.se can tic 
recreated and repopulated in seconds. 

Of course, this can be done under program control as well. 
I keep my datal>u.sc schema scripts as .STR# resources, then, with 
a New commatid, a new daiuba.se can be created anytime. 

At first I was disappointed that I couldn't write the 
equivalent of Sybase stored procedures to hicilitate queries. I 
then realized that I was equally well off not licing able to write 
and invoke stored procedures, liccause 1 was able to implejneni 
these procedures as C or C++ routines. I found tljai where 1 had 


Want to share a tip with 
the community and 
get paid for it? 

Send it in to 

<mailto:tips@mactech.com> 


become accustomed to writing complex SQL select statements 
with extensive loin clauses, 1 could, with diF/SQl, create a couple 
of separate workspaces, then use nested for loops to perftjrm the 
same queries in a faster, much more logical fashion. 

For those of you not familiar with SQL, the implications of 
this are significant. The SQL join command to resolve 
relationships takes lots of memory. In contrast, successive select 
statements which use the results of one SQL statement as input 
to the next SQL select statement takes almtxst no memory at all 
and with dtF/SQL is probably faster than doing the original join. 
The bottom line here is that one does not have to become an 
SQL guni to use dtF/SQL effectively. Arguably, such expertise 
may even work against you. The webbased, downloadable 
distribution comes with several complete, non^trivial example 
programs which demonstrate the usage of almost all of the APIs. 

If Only,,. 

dtF/SQUs implementation departs from the Macintosh 
application & dcxiimcnt paradigm in one respect. In release L6 
the database Ls aaually two files, a database file and a separate 
file used to store BLOB data. This can present some challenges 
to die double-clickable dtxiument interface, 'fhe application must 
determine the location of the other file and then open it* For 
situaiiom where a BLOB file is not required, an empty BLOB file 
can be created on the fly and ojiened, then deleted when the 
database session is over. If a BLOB file is required, one can use 
a Windows and Unix trick and require that the data file and 
BLOB file have tlie same name but require that the BLOB file end 
witii the word “BIOS". Not truly the Macintosh way of doing 
things, bur it works well enough, 

'fhe rerjuiremeni of a separate BLOB file will be removed in 
relea.se 1.8 which is expect to be available in early 1998. Then 
BLOB data will stored with all oilier data in the single file* 

AvAnABiuiy 

The dtF/SQL object library Ls available for Macintosh System 
7.x and Mac OS 8 (68K and native PowerPC). MPW C/C++ , 
Symantec C/C++ and Code Warrior G/C++ are suppoaed. 
Separate versions for HyperCard, SuperCard, AppleScript, 
MacUTTP CGI, Smalltalk Agents and other environments are 
available. dtF/SQL also is an integral component of the Internet- j 
enabled client/server development system from Pictorius, Inc. I 
and the Oberon/F-based client/server system from microsystems. 
The dtF/SQL engine is also available for DOS, Winl6, Win32, NT, 
0$/2, SUN OS, HP/UX and Linux* You must purchase support 
.separately, It is provided by e-mail and is timely and informative. 
The documentation is supplied as PDF files which can be 
read with Adolx: Acrobat. 1 would have preferred hard copy, 
especially for the API definitions when first learning the library. On 
the other hand, these APIs are few and are learned quickly. Ihe 
code examples are excellent and non-trivial. There also are some 
third party examples which range fnim to obvious to obfascated. 

The CodeWarrior CD-ROM distribution contains a demo 
version of this product, dtF Lite, as well as some experimental 
PowerPlant clas.ses which encapsulate the dtF/SQL API. The 
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scandalone claiabaNL' ukjI, diF/Aduiiii, also is provided md is veiy 
useful of anyone who wants to learn more about relatitinal 
databases and the SQL syntax in geneml 

'Ihe database and BLOB files are Ijinary mnipatible between 
Macintcxsh, PC, and Ur^ i>latfomts, making the dtiVSQL engine 
and database files a perfect candidate for distribution on CD-ROM. 

'Ihere are ODBC drivers for dtF/SQL kir Win 16 and Win32; 
Macintash ODBC drivers will l)c ported shortly. Suppoft for Java 
JDBC is under development and should be part of the upcoming 
version 1.7 release. 


SCAUVBliri’Y 

Once you have deployed your application, your users may 
come back and ask about scaling up so that the members of their 
organizations can use your apfilkation to examine and mcxlify 
sliared data. Do^s dais mean that you will have scrap your work 
and learn to use Sybase, Oracle, or ODBC libraries? No! diF/SQL 
is available in a client/server configuration; so, as a develojx^r, you 
add a few lines of coronection code and relink your existing souae 
with the dlF client library. Your customer purefoLse^s and nms the 
dlfVSQL server for their database files (licensed separately from 
SLAB, downloaded from the wel) with a password). They can now^ 
use your newly relinked application, with its familur LIl, to access 
and share their data. Jlie dtP'/SQL LAN server nms on Macintosh, 
Windows 95/NT, and some Unix plaifonns. Version 1.7 will allow 
any diF/SQL client to connect to any dtF/SQL server. 

Recommendation 

I i^an unconditit)mlly rectamnend die dtp library to any 
programmer who wants to develop and deploy solutions which 
deliver performance and simplicity to the aisuamer. As for 
robustness, let me add in conclusion that 1 have crashed alxaut a 
thousand times during development and have never had a 
dtF/SQL database file become corrupt as a result. 

Prking 

All single user non-commercial dtF/SQL pixxlucts are free and 
can be downloaded from the web, including dcxurneniatiiin. 
There are no restrictions sut:h as time-ouLs or maximutit record 
sizes with llie downloaded product. Non-commercial uses of the 
engine are also free. Distribution of commercial prcxlucrs are 
priced on a unit basis. Large volume pricing cm bring the price 
down to 1 DM (alxjui $0.65 US) jx:r Linit. For seiv'er pricing contact 
SLAB directly by e-inail or phone, available from their web site. 

Relational 
Database System 


USETOl. IIRI.’S 

<http://www.slab.de/uk/homepage/index.html> Ls sLalj's home piige. 
in Englisii. All dlF products, commercial and non-commercial, are 
available from this site. 


StoneTable 

You thought it was just a replacement 
for the List Manager ? 

We lied, it is much more ! 

Tired of always adding just one more feature to your LDEF or 
table code ? What do you need in your table ? 

Pictures and Icons and Checkboxes ? 
adjustable columns or rows ? 

Titles for columns or rows ? 

In-line editing of cell text ? 

More than 32K of data ? 

Color and styles ? 

Sorting ? 

More ?? 

How much longer does the list need to be to make it worth 
$200 of your time ? 

See just how long the list is for StoneTable. 

Make StoneTable part of your toolbox today f 

Only $200.00 MasterCard & Visa accepted. 

StoneTablet Publishing 
More Info & demo Voice/FAX (503) 287-3424 

http://www.teleport.com/~stack stack @ teleport.com 
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by Edward Ringel 


Jovis, a Database Engine in a Tiny Package 


A robust database engine 
for HyperCard and other 
XCMD compatible 
environments 


architectural database capabilities for envirunmenLs that support 
XCMD’s and Xf^'CN’s. This is a comprehensive, well 
documented product that can support knowledge base 
development and mt>re traditional database functions in a 
numl:>er of different user settings. 


InTKODUCTK)!^ 

Knowledge base development, 
particularly contract or in-'house 
development, does not require a C, Pascal 
or C++ environment. To the contrary, 
many corporate databases and 
commercially deployed knowledge bases 
arc well supported by database languages 
such as Fourth Dimension. Other 
knowledge bases use an authoring front 
end along with an attached database 
engine. For example, I use a product 
called Scientific American Medicine, a 
complete electronic textbook of internal 
medicine, that is extensively cross 
referenced and searchal>le. It was 
developed with a MacroMedia Director 
from end. High level, programmable 
authoring environments such as 
HyperCard, SuperCard, and Direaor can 
be panicularly appropriate when the 
knowledge base includes pictures, sounds, 
and videos. These environments are 
inherently multimedia capable and require 
little programming knowledge to play a 
QuickTime clip or show a PICT. 

jovis, by DAS Works, is an extended 
XFCN that provides broad relational and 


Oirr OF THE Box 

I received a single disk, a serial number, and a big book. 
The product comes as a single user SDK or an individually 
configured Qient/Server product; 1 was sent rhe single user 
product for review. In order to use Jovis, 1 needed to install the 
product into a HyperCard stack. 1 could not install tlie XFCN’s 
into HyperCard itself. Installation, rather than execution is 
protected by the serial number. (Licensing is addressed later.) 
The code 1 used is 68K based and is just under 400K. A PPC 
version Ls also available if requested. 

The documentation consists of a l6 lesson tutorial and 
extensive documenratitm of the various calls. As with most good 
d(K:umentation, the tutorial builds nicely upon itself and is easy 
to follow. DAS Works does not supply step by step “solutions” to 
the tutorials; this forces the reader to actually work through the 
projects to see if they work. The demo supplied with the prcxluci 
actually is a culmination of tlie tutorials and is a real world 
example. The lessons address both the relational and 
architectural capabilities of the produa. An introduction also is 
provided to show some of tlic intricacies o( multi-user issues 
such as record locking and tmnsactioiis. 

'Ihe reference section comprehensively addresses the 
Jovis calls. Each entry describes tlic syntax of tlie call, 
provides an example, describes the action of the call, and 
offers relevant comments. 

Although a tutorial for Jovis is provided, there is little in the 
way of more complex examplevS or a section on “putting it all 
together.” I think they must assume that tlie user has a good idea 
of how to use a database. The mtorial teaches the nomenclatuie 


Ed Ringel is Contributing Editor for product reviews for MacTeeb Magazine. When he's not working at the computer or 
enjoying the Maine lakes and woods, he’s a respiratory and critical care physician in Waterville, Maine. He can be reached 
at criogcl®mint. net 
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and specifics of this particular environment, but does not address 
design or the management of a complex environment . 

Tiiii Product 

Jovis sLippons a comprehensive set of relational commands 
and stniciiires. Relational file c reation and openydose operations 
arc very simple and stniightforward, Physiatl files on disk are 
referred to as "collections," and can contain tnulripie tables 
("relations”) and indices. Architectural files are flal file structures 
that allow the sLcjrage, indexing, and rapid retrieval of arbitrary 
size binary objects {Binaiy Large Objects, or BLOBs.) 

Relation and index construction within a collection requires 
sc.^me work anrl programming, as witli any datal)asc .system, jovis 
offers a shortcut to field and index CTcaiion by peniiitting tlie creation 
of a field list or index list. Conceptually, this is like a S I R# fesource 
that is then read into the cieaie funciitin, hut it is supported as a text 
string within the .scripting language of die float end cnviiomnent. 

Reading and writing records can be pertbrmed from script 
variables or directly into fields in a card or background. I^rge 
amounts of data can Ix: read directly into records by an 
ImportData command. Tliis can be particularly valuable for filling 
a knowledge base once the structure has been designed and 
created. 'Ihere also is an ExportDara command. 

Oliviously, an important feature of a relational engine is the 
ability to perform a complex search, jovis does this well, '[here 
is a nice section in the tutorial that describes the various 
comparison opera Ions and how to create comy>ound selection 
criteria. Jovis supports range searches and die creation of 
selections. Multiple selections for a given relation are permitted. 
Merges, which are the same as SQL joins, are supported as a two 
step process. Selections are first created and then merged. Tlie 
tutorial completely explains this process. 

Record locking and transactions ane supported for the 
mulliaser version. Then? is a section on liow the Jovis server works 
at a file level, but the manual does not teach you how lo undertake 
the design and deployment of a shared, multiuser cbitabase system. 
Calls provided, however, will fMiTinit the knowledgeable user to 
implement a robust, safe multiuser database. 

Tlie arcltitectural commands are as important as the relational 
instructions. Multimedia developers will make heavy use of BLOBs 
and managing dic-se olijecls Ls critical. One very nice feature of 
Jovis is its ability to eniltsed an architectural file within a relational 
file, permitting linkage of relational recotxls to architectural indice.s. 
As with the relational commands, there Ls a scries of tutorials tliat 
leaches the user how to manipulate flat file coasuxicts in the Jovis 
environment, 'fhe tutorial specifically teaches how to use 
architectural and iTelalional commands and cfinstmcLs LogeLtier, 
which for many dcvciofx?rs may lx* the heiiit of the product. 

Using Jovis 

Jovis can lx used in any XCMD compatible envimmiicnL 1 
tested Jovis in a somewhat older version of I lypetCaid as well as the 
airrent version. It also will run in SuperCaid, Director, and Oracle 
Media Objcx:Ls, Jovis ha.s an iniiial startup memory rLX[uiremcnL of 
512K over and atxve tliose of die scripting environment, in some 


erases, the laigcT the daiaba.se die greater flic memory requirement. 

1 found the product difficult to benchmark in a meaningful 
way. Particularly in a multimedia setting, with various scripting 
environments and different hardware cronfiguratirms, any 
comparison might well lx irrelevant to the user/programmer. My 
overall impression was that pertbmiance was more chan adequate. 

Use of the product requires that the programmer follow 
.some tronvenlions regarding the need for the programmer to 
create several glol)al variables which would then be for the use 
of the database engine nuher than fhe stack. 

One very nice feature of this product is very good error 
management. In addition to the XFCN managing and 
communicating enors, it is possible for your script to intercept 
and handle error conditions as well. Tlie ability to provide more 
than "plain vanilla" dialogs reporting an error condition with 
graceful recovery is critical to a commercial product. 

It was difficult to pick a representative complete script to 
give a flavor of how the product is used. In the end, 1 simply 
took ilie first one in the tutorial, denionstiating creation of a 
relational file: 

function CresteRewPile 

global myDB, JovlsErrotCode 
—myDB is reserved for exchuiive use by Jovis 
if taybB = empty lb011 
put "Jovis" into myDB 
—inilialLce myDB 

get Jovis("CreateCoilection" , "uvyDB") 

—all calt*> to Jovis arc m the forniat get JovisO. 

—with the llrst parameter the action selector 
if 1 of JovisErrorCodo = "error" then 

answer JovlsEtrotCode 
put empty into iiiyDB 
return "false" 

else if item 1 of JovisErrorCode “ "Warning" then 
answer JovisErrorCode 
put empty into myDB 
return "false" 
end if 
else 

return "false" 
end if 

return "true" 
end CreateNewFile 

I [ere are some other brief examples: 

Create a relation named customer.s in flic file myDB: 

on CroateDemoKelation 

get Jovis("CreateReiation"* "myDli", "Customers") 
end CreateDemoRelation 

Create an text index of 8 character length named Last_Name 
in the relation Customers In the file “myDB" 

on CreateTextIndex 

gat Jovis("Craatelndex". “myDB". "Customers". 

“Last_Naine". "text", 8) 
end G r eateTexr. T n d ax 

Perform a selection searching on Las£_Name in our 
liypothetical Customers daral>ase: 

on DemoSelect 

ask "Enter last name to set selection to:" 
if the result ^ "cancel" then exit DemoScript 
put it into Lastjilame 
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PuL "Field Last_^ 3 atfie ” ["& fir"]" Into CrtterJa 

Put "Lasi_Najiie^ phone, CusLomcE:_IO, AccoLinL_Siart" 
into FieldList 

get Jcivi5{"Set Selection". "inyDB", "Custoniers", 
fieidList. Criteria) 
end DeraoSelect 

While I have not cominented tliis code, I think the general 
sense of the steps and syntax is apparent. 

Licensing and Costs 

This product has a somewhat complex licensing 
arrangement. Ihe basic price for a single user license (single 
computer for nQn-c:ommercial distribution) is $3'^5. Thus, the 
person creating a datiil^ase for personal use is spared die 
expense of a full commercial license. If the database will be used 
on more than a single computer an additional fee of $350 is 
rct]uircd. This additional fee covers everything from unlimited 
commercial distribution to simultaneous use of the single user 
product on a second computer in the same office. 
Hyp<.)thetically, a knowledge base with a HyperCard front end 
and a Jovis database dial sells 1000 copies still only costs you 
$695 in license fees to UAS Works. Not too shabby. 

'Hie server version is more expensive, but again within 
reason. The basic: niultinser pac:k:age c:c>mes with a server and a 
liircc user license and costs $435. Each additonal user costs $85. 
'Ehe server prodiici is protected by a hardware ADB lock. 
Licenses for the commercial distribution of a multiuser product 
developed with JovLs arc‘ handled on a erase by case basis. 


The Boti'om Line 

Jovis is a relational and Oat file engine that lives in the 
XCMD world, It has a complete set of relational commands 
nicely complemented by architecniral commands. The two 
schemes can be used together to create traditional relations 
supplemented by BLOBs: a perfect combination to implement 
multimedia presentations. Although difficult to judge^ it appears 
that performance is more than adecftiaie. Tlie pricing scheme 
has many steps but Is fain Were I developing multimedia on 
Macintosh, I would give this produce serious consideration to 
implement my work. 

It wa>uld be very helpful if DAS Wtjrks created a “User 
Manual.” The reference manual and tutorial are both quite 
good. However, once the user is acquainted with the product, 
he or she will want a doaiment on putting it all together 
without needing to browse the tutorials again, and something 
more cohesive than a function call reference. Additionally Jovis 
is sufficiently different in structure and tiomenclamre from SQL 
that .some in depth solutions to complex examples are 
warranted. Finally, 1 respectfully suggest a set of text files 
containing the scripts lor each of the tutorials. 

PRODUc:i>i Reviewed 

Jovis Single User SDK version T()4. DAS Works, Inc. 250 
West 104th St, Suite 84, New Ycmk, NY 10025-4292. Toll free 
(800) 972-2483. Fax (212) 663-4503. email to 

<info@dasworks.com> or <sales@dasworks.com>. There is a 
website at <htlp://www.dasworks,com/>. BQ 


Help Make MacTech Work 


IltTe at MULTech Magazim, we ivjy heavily on 
outside v^Titers tor mast o\' tfie niaterial that 
api^^aiTi in our pages. if leaders did not 
partkipate in the magazine, sending us their 
ideas and taidng the time to write articles, there 
would he no Mac7ecb. Maclecb Magazbw Ls 
not a sitiff of wTiters sending a constant stream 
of one-way messiiges outw'ards: it’s a living, 
evolving nctwxjrk tf teadens conversing with 
one another, educating one another, sharing 
their knowledge, their experience, their inleic‘sl, 
ibeir trials and irihulatioas and joys ami 
sucomis in the amsiantly unibkiing story of 
pn,igmmining the Macintosh. MacTech 
MagaTiiw d<Kfsn’t jnst ha[>|>en: it’s wtial ttie 
community makes it: If we cany rejXJrts iif 
Riture Dends and tedinologies, if we teach 


iLsekil inetlicxls, il vve review new IxK^ks and 
tools, if w'e pixiwoke thought, pnwitle hetji. ride 
the wave of current interests and OTnaa-ns, it is 
only lieoiu,se we reflixi the thoughts of our 
readers, who speak through our pages. 

You are invited t<j involve yoiir.self in 
this exciting conversati<}n amongst readers. 
No nianer who you are, no maner what your 
credentials may l>e, if you have a talc to tell, 
a trick to .share, a technique to teach, we 
w^ant you to consider joining die family of 
those who write For MacTech. 

Don't just wail for a topic to lx: covered 
or a technique explained in Mac Tech! Take 
responsibility! Write us an arlide your.sein 
To write for MmTiXh, just send for our 
Writer's Kit. It’s a MiciTxsoft Woixl file 


containing the Styles you need to use, and 
giving lots of helpful advice and inforrmition, 
including all the legal stulL You can let us 
know what you Ye writing alxiut, or, if you 
want to. you can just write the article and 
spring it on us when it's done. [Note; We 
also have a need for people willing to make 
themselves available to write cx-casional 
pr(xliKt/b<x)k reviews.! If we puldish your 
article, yoifll he paid Ibr ill 

Write to us. the editorial staff, at 
cxlilori;il@uianedct:om (or one of the other 
addresses listtxl on jxige 2 of the maga/rne). 
Take the htture of MacTech Magazine into 
your own liands! 


FiM AritMUt# 
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TOOLS OF 
THE TRADE 


by Michael Rutman, indelxmclent consultanl 


Macworld Developer Tools Roundup 


Wbal’s new on the 
tools for developers 


MaCWOR!.D and THF Neei>s 

Ws always ID see new protlucts 
at Macworld* and this year was no 
exception. I'his year, there were srniie 
concerns about w^hether there w(mld 1 k‘ 
any new or exciting things in the 
developer tools market. The tool 
developers pleasantly surprised everyone 
by showing a whole slew of new tools as 
well as new versions of old tools, 

A few companies canceled their 
products claiming lack of sales, but 
other companies quickly jumped into 
the void. The new companies have gone 
far beyond w^hat the old companies ever 
tried to acrornplish. Most likely, those 
companies that are now gone actually 
lost sales to competition rather than a 
shrinking Macintosh markel. 

Developer T0015 

The i:ore developer’s pac:kagc these 
days is Metro works CodeWarrior. 
Metrowerks is now shipping CodeWarrior 
Pro 2.0, as well as a large numlx-T of 
subsidiary f)roducLs, .such as SourceSafe 
and Lititude. CodeWarrior is their main 
development IDE with their compilers, 
and for most Maciniosh developers, 
CtxleWairior Pro 2.0 is a must buy. 


SourceSafe is a t:ross-plalfonn source control system. It 
inicgraics with CtxleWarrior, and is supposed to be easy to 
use. Metrowerks started with Microsr>fPs source code, and 
they have been bringing it to the Maciniosh for .scvenil years, 
giving ii si ability and a Madniosh user exf)erience. 

Latitude is a library for porting Macintosh applications to 
Rhapsody. Tor developers with an existing c:ode base tliaL 
want to live in a Rhapsody wt>rld, Uititude is a must buy 
product. Meirowerks is using Latitude to pon their IDE to 
Rhapsody, so Latitude is getting a major workout. 

In addition to Macintosh tools, Metrowerks also provides 
development envirtmmcnls ft>r creating applications on other 
platforms, such as BeOS, Palm Pilot, and embedded 
controllers, IVe been told there are now 10 back ends for the 
Metrowerks IDE. 

In addition to Metrowerks IDE, another must buy tool is 
Kesorcerer from Mathemaesrhetics. Kesorcerer is ihe prime 
resourt'e-editing tool. For many years, ResEdii, being free, was 
the premier tool. With Resorcerer 2.0's new features, and 
ResEdit’s lack of suppon, most developers will now switch 
over to Kesorcerer, despite its very high price. At S256 a copy, 
Resf)rcerer is eurrently one of ilic most expeasive developer 
tools on die market. 

Kesorcerer has always been a resource editor, but done 
with the Maciniosli liH)k and feel. Creating an AIRT (alert) 
resource didn't just CTCate a resource, it created the entire 
family of resources alerts need (aetb, ALK f, DlTl., n!.GX, ictb). 
Each resource created is linked together, and all of iheni can 
be edited graphically. Kon-graphica! resources, such as .string 
lists, are edited using a template. New templates are ea.5y to 
use, and ResEdit templates can be imporletl 

Resorcerer 2.0 goes lx. 7 ond resources and includes the 
ability to edit any type of file as a container. Originally 
planned for Copland, Resorcerer moves away from the 


Michael Rutman Is an indcpcndeni software developer for Macintosh and NeXTSTEP. While working at Software Ventures, 
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resource fork nature of Macintosh files, and instead treats all 
forks like a container that can hold resources. At first, this 
may sound like a move away from where its power is, hut in 
reality, it extends the usefulness of the tool, ft is now possible 
to put resources in the data fork. As strange as this sounds, 
there have been many programs IVe worked on where we 
have embedded resource-like information in the data fork. 
With Resorcerer's template ability, we would have been able 
to edit thisS information graphically. 

Another nice product shown was AppMaker version 9. 
AppMaker's followers will swear by it and refuse to use any 
interface-creating tool. AppMaker is a bit like Metrowerks’ 
Constructor in that both create the user interface's applications 
display. Where they differ is in lx)th tlieir power and tlicir ea.se 
of use. 'fhe easiest way to describe AppMaker is to compare it 
to Constructor and show where AppMaker shines. 

The biggest failing of Meirowerks’ Con.sirucior is that its 
ppob holds only half tlie infoniiation needed to create an 
interface. Custom views need to be coded in a source file, and if 
tliere is any disagreement between the code and the ppob, the 
window won't display correaly. Furtliermore, controls have to 
he hooked up to actions programmatically. There is no way to 
test an interface without writing code. 

With AppMaker, when an interface is done, source files 
are generated to produce the desired user interface. The 
source files produced can be Pascal, C, C++, PowerPIant, and 
others. The source generated includes all the code for 
creating and hooking up views, including cusunn views. Tfiis 
automation prevents many errors that creep into 
Code Warrior projects that use Constructor. 

Another nice feature of AppMaker is its sepamtion of user 
interface and hack end. AppMaker ereales source files that 
control the user interface, and creates stub files to talk to the 
.source files created. With this model, a change in the IJt does not 
break the underlying code. This mtxlel also helps prevent the 
proliferation of objects that do nothing more than tell PowerPIant 
which window is being loaded. 

The demo of AppMaker was a Fahrenheit to Celsius 
converter, It consisted of a window with 2 text field.s, a .slider, 
and a thermometer Using the inspector in AppMaker, 
controls were hooked up, formulas were created, and 
everything was done. Four lines of code, selecting create 
code, a compile, and it worked. No interaction with the 
source files was necessaty at all. When asked how hard it 
would be to programmatically change the values, 1 was told 
that all the variables have public assessor methods, and 
calling those will change the values everywhere. 

The next type of developer tool everybody has need for 
is an installer. The insLallcr market has been going through a 
shakeup over the last few' years with large numbers of 
companies going from Aladdin's InstallerMaker to 
MindVision's VTSF. Both Aladdin and MindVision have new 
versions, and both respond to fundamental nced.s of tlicir 
customers. A comparison between the two products is always 
tricky^ but both offer limited versions on their web site to 
allow everyone a chance to see for themselves. 


Aladdin's biggest customer problem was speed and ease 
of use. Earlier versions of InstallerMaker could not hold up in 
a comparison again.si VISE, and InstallerMaker sales suffered 
for it. InstallerMaker uses tfie tried and true StuffiL Engine to 
get good compression reducing the size of the packages for 
installation. I'he new version of InstallerMaker adds installing 
from ftp sites, uninstalling, Lime-limited demos, and updater 
files. Overall, it looks like Aladdin is finally responding to 
Mind Vision's growing market share. 

In the last year or tw^o, MindVision grabbed the lead with 
a clearly superior product. Their late.st version capitalized on 
their lead to add a slew of new features, VISE now has 
hierarchical packages, multiple targets from a single script, 
cusumi layout, [setter drag and drop support, belter billboard 
support, web installer, and many other new features. VISE 5-0 
has an improved user interface that many developers will find 
even ea.sier to use. 

Anotlier must have tool is Bare Bones .software's BBEdit 
4.5, BBEdit has always been a useful tool, and it just gets 
lietcer. Many Lfnix users .show off the power of emacs and say 
die Macintosh is just a toy. I can always respond by launching 
BBEdit and saying emacs is just a kludge. BBEdit is the text 
editing tool for the Macintosh that puts any other text editor 
on any other platform to shame. If I sraned listing all the 
features of BBEdit now, I would not finish before they came 
out with a new version with even more features in it. Not only 
is BBEdit a powerful and useful tool, its relatively cheap price 
makes it a must buy product. 

Altu ra soli ware has a new version of ObjectMaster. 
ObjetiMaster understands C++, Objective-C, and Java objects, 
and allows browsing the objects. While other editors, such as 
Melrowerks and BliEdit, allow .some cla.ss browsing, 
ObjectMaster is built around it. A large number of features 
make ObjectMaster a very useful tool to have around. 
ObjectMaster does not suppoit compiling a program, hut will 
seemlessly talk to most IDE’s, including Metrowerks and MPW. 
Altura has done a good job of creating a development 
environment where you code like you design. 

The last developer tool is a different type of ^^tool”. 
Developer Depot, liowever, is genuinely a useful tool to have 
in that they have all the developer tools for sale at a good price 
(with lowest price guaraniec). In addition, they help sponsor 
tlie pavilions and aLlvertising for other developer tools. For a 
developer wanting to buy one or more of the products iVe 
dest:rihed, DeveU)pcr Depot is a must contact company, 
fDisclaimer: While l>oih DevelopcT Depot and MacTecli 
Magazine are run very separately, they are owned by the same 
parent company.] 

.MacTech also has a CD with all of ii.s issue through May 
1997 fully indexed. Anyone who has let their subscriptions 
lapse for a year or two, should pick up the CD and see what 
they missed. 
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Rhapsody Development Tools 

There were a few Rhapsody devel<,)pment tcxjls the 
show, buL the only one I found useful for Macintosfi developers 
right now is Joy. There are other useful and cool Rhapsody 
tools coming soon, but Joy was shown at Macworld The demo 
of Joy is overwhelming, and a full review would be hard 
pressed to do this pn;>duct justice, but I believe that Joy takes 
development tools to a new level, 

Basically, Joy is a command line interface, which can be 
added to yc^ur application. The letlmology behind the 
command line relies on Rhapsody's dynamic method dispatch 
mechanism. Any object can be accessed, and any method can 
be called. As everything is done at run-time, any method with 
any parameters can be called on any object in any application 
linked to Joy. 

While an interactive command line to an application is a 
powerful tool, tiic creators of Joy fiavo gone way iK^ond what 
fVe described. Hopefully, at a later time, we can present a hill 
review of Joy to our readers. 

OriiiiK Tools Developeks Would Find Use ifi 

while developers will use most productivity software, 
there are some products, such as product management 
software, that are of interest to developers even though they 
are not developer-only tools. Walking the show floor, 1 found 
quite a few new products that many developers will find a 
Li.seful addiLicm. 

One of the current dilemmas facing Macintosh 
programmers today is cross-platform connectivity. AppleShare 
is a great tool for transferring files between Macintoshes, but 
when Windows machines are involved, something extra is 
needed. Two products resolve this, Miramar’s PC Maclan, and 
Dave. Both products allow file transfer and printing between 
the platforms, but they do it from the opposite sides. Dave is 
installed on the Macintosh and runs on the Macintosh talking 
Windows, MacLan installs on a Windows machine with 
Macintosh clients talking their own language. Depending on 
your situation, either product may be more appropriate. As a 
Macintosh user, 1 found MacLan difficult to install, but Tm sure 
that anyone who kr^ows Windows would find It easy. 

Dave, on the olfier hand, installs and acts like a Macintosh 
program should. Without reading any installation directions, I 
installed Dave, and in the Apple Menu, there was a DAVE 
Acce.s.s menu item, exactly like T expected. Opening it told me 
that I had not configured NetBIOS, and told me where to go to 
configure NetBIOS, From the NetBIOS control panel, as 1 
moved the mouse around, each field was described below; a 
kind of contextual help that made configuring easy. The only 
down side to Dave was my needing to go to the Windows 
machine and set up domains and stuff. 

Another useful tool I saw was PageCharmer. 
PageCharmer is a set of useful Java widgets ready for 
customization and insertion into a web site. Most developers 
1 know have a web sire, and making a cool web site can drain 
hundreds of hours. There are many web page creation tools, 


from DreamWeaver to RBEdit, but PageCharmer isn’t for 
creating web pages, it’s for adding the widgets to make a 
page look nice. It has a very nice interface, and customizing 
buttons and maps was very enjoyable. 

While not a tool, I did look at the Contour mouse. The 
Contour mouse is molded to fit the hand, and different size 
mice are available. As 1 suffer from a bit of RSI, I am always 
looking for new ergonomic devices. The mouse has a 
different feel from the trackball and nonnal mice, 1 don’t feel 
the need to grip it as hard as a normal mouse, but i do feel 
it a bit more in the elbow. I haven’t had the mouse long 
enough to know if it works better or not, but I suspect that it 
will help my wrist, where 1 need it most. The mouse does 
have two drawbacks, and both of those are oniy reievant if 
you share a machine. The mou.se, being sized and molded, 
will only fit my middle-sized right hand. If my wife, who is 
left-handed and has a smaller hand, wants to use my 
machine, she will have trouble. 

Conclusions 

Quite a number of new and updated products were all 
over the show floor. A lot of good hard work has gone into 
making developers’ lives easy. For those that could not attend 
the show, I hope Fve been able to bring you just a taste of the 
tools that can make your programming easier. Mi 
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JAVA 

WORKSHOP 


by Andreiv Downs 


Java Serialization 


Adding object persistence 
to Java applications 


Introduction 

This article discusses and 
demonsiratcs how to incorporate object 
persistence into a Java application using 
ihe serialip^ation mechanism in Java 1. b 
This article assumes a general familiarity 
with Java. The code in this article was 
developed using the Apple Macintosh 
Kuntime for Java (MRJJ version 2.0 and 
the MKJ SDK. 


Overview 

Serialization involves saving the 
current state of an object to a stream, 
and restoring an equivalent object from 
that .stream. Tlie siream functions as a 
container fcjr the c)i>ject. tts contents 
include a partial representation of the 
object’s internal structure, including 
variable types, names, and values. The 
container may be transient (RAM-based) 
or persistent (disk-based). A transient 
container may be used to prepare an 
o!)ject for transmission from one 
computer to another. A persistent 
container, such as a file on disk, allows 
storage of the tshjcct after the current 
session is finished. In both cases the 
information stored in the container can 


later be used to construct an equivalent object containing the 
same data as the original. The example code in this article 
will focus on persistence. 

Since Java applets do not have direct access to a local disk, 
it may be impossible for an applet to find a suitable container for 
fjcrsistent stomgc of a serialized object. Therefore, the code in 
tiiis article focuses on Java applications. 

IMPLEMENTAIION 

For an object to be serialized, it must be an instance of a 
class that implements either the Serializable or Externalizable 
interface. Both interfaces only permit the saving of data 
associated with an object's variables. They depend on the 
class definition being available to the Java Virtual Machine at 
reconstruction time in order to con.stnict the object. 

The Serializable interface relies on the Java runtime 
default mechanism to save an object's state. Writing an object 
is done via the writeObject() method in the 
ObjectOutputStream class (or the ObjectOutput interface). 
Writing a primitive value may be done through the 
appropriate write<datatype>() method. Reading the serialized 
object is accomplished using the readObject() method of the 
ObjectinputStream class, and primitives may [)e read using the 
various read<datatype>() methods. 

What about other objects that may be referred to by the 
object we are serializing? Fcjr instance, what if our object is 
a Frame containing a set of (AWT) Panel and TexcArea 
instance variables? Using the Serializable interface, these 
references (and their associated data) also are converted and 
written to the stream. All state information necessary to 
reconstruct our Frame object and any objects that it 
references gets stored together. 


Andrew Downs is a Senior Softw'arc Engineer for i'cmplaic Sofiwam in New Orleans, lA, designing and building enterprise 
apps. He also teaches C and Java progminming at Tulane University College. Andre^-^ wrote the Macintosh freeware progran> 
Recent Adtiitions, and the Java a[i[5lication UDPing. You cau reach him at andrew.downs#template.com. 
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If those other objects or their formats weren’t stored, our 
reconstructed Frame would contain null object references, and 
the content of those Panels and TextAreas would be gone. Plus, 
any methods that rely on the existence of the Panels or TextAreas 
would throw exceptions. 

The Externalizable interface specifies that the 
implementing class will handle the serialization on its own, 
instead of relying on the default runtime mechanism. This 
includes which fields get written (and read), and in what order. 
The class must define a writeExternafO method to write out the 
stream, and a corresponding read Extern al() metlKxl to read the 
stream. Inside of these methods the class calls 
ObjectOutputStream writeObject(), ObjectInputStream readObject(), 
and any necessary wrtte<datatype>() and read<datatype>() 
methods, for the desired fields. 

HroiNG DATA 

Sometimes you may wish to prevent certain fields from 
being stored in the serialized object. The Serializable 
interface allows the implementing class to specify that some 
of its fields do not gel saved or restored. This is accomplished 
by placing the keyword transient before the data type in the 
variable declaration. For example, you may have some data 
which is confidential and can be re-read from a master file 
later (as opposed to saving it witli the serialized object). Or 
you decide (wisely) to preserve the privacy of file references 
by declaring any such variables as transient. Otherwise, all 
field.s automatically get written without any additional effort 
by the class. 

In addition to those fields declared as transient, static fields 
are not serialized (written out), and so cannot be deserialized 
(read back in). 

Another way to use Serializable, and control which fields 
get written, is to override the writeObject() method of the 
Serializable interface. Inside of this method, you are 
responsible for writing out the appropriate fields, If you take 
this approach, you will want to override readObject() as well, 
to control the restoration process. This is similar to using 
Externalizable, except that interface requires writeExternal() 
and readExternalO- 

For the Externalizable Interface, since both wfiteExternal() 
and readExternaH) must be declared public, this incTCases the risk 
that a rogue object could use them to determine the format of 
the serialized object. For this reason, you should be careful when 
saving object data with this interface. 

it is worth considering the amount of security you need 
for any objects that you serialize. When reading them back in, 
all of the normal Java security checks (such as the bytecode 
verifier) are in effect. You can define certain values within the 
class that should remain intact in serialized objects. Perhaps 
they should contain a specific value, or a value within a 
particular range. You can easily check the value of any 


numeric variable read in from a serialized object, especially if 
you know that only a portion of the available range for that 
data type is used by your variable. 

You can also encrypt the outgoing data stream. The 
implementation is up to you, and don't forget to decrypt the 
object format when reading it back in. 

Versioning 

ITie ability to save and restore objects leads to an interesting 
questitm: what happens when an object has been stored for so 
long, lliat upon restoration it finds that its fomiat has been 
superceded by a new, different version of the class? 

The stream reading the serialized representaiion is 
responsible for accounting for any differences. The intent is 
that a newer version of a java class should be able to 
interoperate with older representations of the same class, as 
long as there have not Ix^en certain changes in the class 
structure. The same does not necessarily hold true for an 
older version of the class, which may not be able to 
effectively deal with a newer representation. 

So, we need some way to detennine at runtime Cor more 
appropriately, deserialization-time) whether we have the 
necessary backward compatibilit)c 

In java 1.1, changes to classes may be specified using a 
version number. A specific class variable, serialVersionUID 
(representing the Stream Unique Identifier, or SUID), may be 
used to specify the earliest versitin of die cla.ss tliat car he 
deserialized. The SUID is declared as follows: 

static final long serialVersionUrD = 2L: 

This particular declaration and assignment specifies tliat 
version 2 is as far back as this class can go. It is not compatible 
with an object written by version 1 of the class, and it cannot 
write a version I object. If it encounters a version 1 oi>ject in a 
stream (such as when restoring from a file), an 
invatidClassException will be thrown. 

The SUID Is a measure of backward com pad hi lily. The same 
SUID can be used for multiple representations of a class, as long 
as newer versions can still read the older versions. 

If you do not explicitly assign a SUID. a default value will 
be a.s.signed when the object gets serialized. This default SUID 
is a hash, or unique numeric value, which is computed using 
the class name, interfaces, methods, and fields. The exact 
algorithm is defined by the Secure Hash Algorithm (SHA). 
Refer to the Sun java documentation for details. 

The JDK (MRj) utility program serialver will display the 
default (hash) SUID for a class. You can then paste thi.s value in 
any subsequent, compatible versions of the class. (It is not 
required in the initial veBion of the class.) As of this writing the 
serialver program has not been included in the MRJ SDK, but 
hopefully will be in the future. 


continued on page 66 
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CHALLENGE 


by Bob Boorisira, Westford, MA 



Mancala 

A stocking stufTer from this past Christmas provided the 
inspiration for this month's Challenge, Santa gave me a \wo 
player travel game called Mancala which might provide some 
amusement the next time 1 travel by car or by plane, provided 
the ride is smooth enough to keep the small stones inside the 
bowls of the game board. T thought it might make for an 
interesting Challenge tournament, 

'I'he basic Mancala game consists of a board with 14 
hoi I owed" out bowls arranged in an t>val form, one large bowl 
at each end of the board, and six smaller bowls facing each 
of two players seated opposite one another. Each player 
"^owns’' the large bowl, or “mancala^ positioned to his right, 
and the six small t>owls clo,scsi to him. The game starts with 
each small bowl containing four stones. The game begins 
with the first player picking up all of the stones in one of his 
small bowls, dropping one stone in the howl to the right, the 
second stone in the second bowl on the right, continuing 
around the board in counterclockwise fashion until the stones 
he picked up are gone, fhe second player then picks up the 
stones in one of his smalt bowls, drops them one at a time in 
the bowls to the right, etc. The game ends when one player 
cannot move (i.e., no stones remain in that player's small 
bowls). The winner is the player with the most stones in his 
mancala. There are a number of variations to the game, and 
the specific restrictions on our Mancala Challenge tournament 
are explained below. 

The prototype for the code you should write is: 


#if definedf cpluaplus) 

extern ‘'C” [ 

ffendif 


Boolean MancalaC 

long board [] , /* on entry, board[1) is number of stones in howl i 7 

/* on exit, board reflects the results of your move 7 
const 1 ong b oa rd S i ze, /* number of bowls in the board, including manealas 7 
void * p rivStorage, /* pointer to IMB of storage for your use 7 

const Boolean newGame, /* true for your firsi move of a game 7 

const Boolean playerOne * /* true when you are the first player 7 
long * bowl Played . T return the munberof the bowl you played horn 7 

long 'dlceccionPlayed /* return I If you played counter-ctockwise, 7 
return 4 if you played clockwise 7 




#lf defined(,_cpluaplus) 

] 

#endif 


Each time your Mancala routine is called, you will be 
provided with a boardO array that indicates the number of stones 
in each bowl, including the Mancalas, at the iicginning of your 
turn. The boardSize parameter wUI indicate the number of bowls 
in the board - in the standard Mancala game, this would be 14, 
but in our Challenge it might be any even numl)er between 8 and 
32, inclusive. The mancala for die first player will be board[0], 
while the mancala for the second player will be 
board[boardSiZ0/2], You will also be provided a pointer 
privStorage to 1 MB of storage, preinitialized to zero, for each of 
your moves in a single game. For your fiist move of a game, 
newGame will be TRUE, otherwise newGame will be false. If you 
are the first player, playerOne will be TRUE for each of your 


THE RULES 


Here's how it works; each month we present a new programmiag 
challenge. First, write some rode that solves the challenge. Second, optimize 
your code (a lot). Then, submit your solution to MacTech Magazine, We 
choose a winner based on code correctness, speed, size, and elegance (in 
that order of importance) as well as the submission date. In die event of 
multiple equally desirable solutions, we'U choose one winner Cwiili 
lionorable mention, but no prize, given to the runner up). The prize for each 
month's best solution is a $100 credit for Developer Depot™. 

Unless stated otherwise in tire problem statement, the following rules apply; 
All solulions must be in ANSI compatible C or C++, or in Pascal, We disquiify 
entries with any asxsembly in them Cexcept for diallenges specifically staling 
otheiwise.) You may call any Macintosh Toolbox routine (e.g,, it doesn't matter if 
you itse NewPtr instead of malloc). We compile all entries into native PowerPC 
code with compiler options set to enable ail available speed optimizations. The 
development environment to be used for selecting the winner will be stated in the 
problem. Limit your code to 60 characiers per line or Lomptess and binliex ifie 


solution; diis helps witli e-mail gateways and page layout. 

We publLsh the solution and winners for each montlVs Programmer’s 
Challenge three rbonths later. All submissions must be received by the 1st day 
of the month printed on tlie front cover of this Issue. 

You can get a head start on the Challenge by reading the Programmer's 
Cliallenge mailing list. It will be posted to die list on or before the 12th of the 
preceding mondi. To join, send an email to listserv@listinail.xplain.com with 
the subject '.subscribe challenge-A**. 

Mark solutions “Attn: Programmer’s Challenge Solution'’ and send it by 
e-mail to one of the Programmer's Challenge addresses In the “How to 
Communicate Widi Us" section on page 2 of this issue. Include the solution, 
all related files, and your contact info, 

MacTech Magazine reserves ihe right to publish any solution entered in 
the Programmer's Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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moves, otherwise playerOne will be FALSE. You should return the 
index of the bowl you played from in bowIPlayed, and you 
should return the direction you chose to move in direction Played. 
You should also update your view of the number of stones in 
each lx)wl in board[]. 

There are a numlxir of rule variations for Mancala. We will 
play with tlie following additions to the standard ailes: 

• the board will contain between eight and 32 bowls, instead of 
the standard 14. 

• at the teginning of the game, each small Ixjwl will have 
between two and 16 stones (instead of die standard four), 
with the same numlxiT in each bowl, 

• fflayers do not drop stones into their opponent’s mancalas. 

• players may choose to move either counter-ckKkwise or 
clockwise on a given move. 

• if a player drops the last stone into his mancala, he gets to 
move again (my test cxKle will call your Mancala routine again). 

• tf a player drops die last stone into one of the empty bowls 
(boardp]) on his side of die board, he takes that stone, plus all 
the stones in his opponent’s bowl directly ac:rtxs.s from liis 
bowl (board[boardSize-iJ) and places them in his mancala, 

• the game ends when one player has no stones in any of his 
small bowls and cannot move. Ihe other player then places 
all remaining stones from his small bowls into his mancala. 

At the end of die game, each player will be credited with 
one point for each stone tn his mancala, minus one point for 
each 100ms of cumulative execution time. Tlie Challenge winner 
will be the entry dial accumulates the most points in a round- 
robin tournament where each entry competes against each other 
entry twice for each set of game parameters, t>nce playing first, 
and once playing second. 

This will be a native PowerPC Challenge, using the latest 
CodeWarrior environment. Solutions may be coded in C, C++, 
or Pascal 


Three Months Ago Winner 

Congratulations once again to Ernst Munter (Kanata, 
Ontario) for submitting the fastest entry to the January Cell 
Selection Challenge. Readers were invited to implement a C++ 
CellSelection class, including methods to add one selection to 
another, remove one selection from another, invert a selection, 
count the number of active cells in a selection, and determine 
if two selections were equal A dual-processor 8500/2x200 was 
used to test this Challenge, and contestants were free to take 
advantage of the multiple processors, either through the 
Apple/Daystar Multiprocessing API, or by programming for 
BeOS and taking advantage of the symmetric multiprocessing 
features of that operating system. 

Or so I thought when 1 struaured the problem. As it turned 
out, of the four solutiems submitted, only one took advantage of 
the muliiprocessor opportunity, i’ll discuss the use of 
multiprocessing in that solution later in the article. 

Ernst based his solution on the ‘'vixet" data structure he used 
to win the Intersecting Rectangle Challenge of two years ago. His 
code is well-commented, so 111 let his solution speak for itself, 
except to point out that one tjlher entry made reference to the 
’*vixer approach. It's nice to see readers pul winning code from 
the past to good (and efficient) use. 

The cable below lists the total execution time in 
milliseconds for all te.st cases, as well as execution rimes for 
five individual test cases. It also lists code size, data size, and 
the number of processors used for each entry. The number in 
parentheses aiter the entrant’s name is the total number of 
Challenge points earned in all Chaheoges to date prior to this 
one. The entries marked with an asterisk are those which did 
not complete one or more lest cases. Test limes in italics are 
extrapolated from partial test cases that were successfully 
completed. (See table 1). 

ULf Schroder's entry was the only one to attempt to use botli 
of the processors available in the test machine. I tested a version of 
lllfs entry modified to ase only one piocessor, but the results were 
not much different, suggesting that either the CellSelection pn)blem 
is not amenable to partitioning, or that IJlfs technique for doing so 
didn’t have much affect for llie |xarticular test cases I used. 

This Challenge was intended to be about multiprocessing, 
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so it is worth spending a minute on how Ulf tried to tnke 
advantage of it. The first step was to determine how many 
processors were available and to create a task entry and a pair 
of semaphores for each processor: 


if t[MFLibraryIsLoaded()) 
gProcessorB = 1; 
else 

gProcesaotB = MPFrocessotsC); 

// Create the tasks if more than one processor 
if (^Processors > 1) 

I 

OSErr err: 


for (iiit32 i = Oi i < gProcessors 1: ++1) 

1 

err = MPCreateSeinaphored, 0. 

^gTaskData li] *mStartSemaphore); 
if (err != noKrr) throw err; 

err = MPCreateSeraaphore(], 0. 

StgTaskData [i] *mFi nlshedSemaphote); 
if (err !“ noBrr) throw err; 

err = MPCreateTask( 

t3sk» &gTaskData[il, 0. gTermlnationQueoe. 

0. 0, 0, igTaskData[il .mTaskld); 
if (err != noErr) throw err; 

I 

Tliis step is done once, at initiaiiisation time. Then later, 
when the code determines that it has a problem wortli 
partitioning, it divides the problem, assigns one piece to another 
task (or tasks, in the general case), signals the other task to begin 
work, solves the remaining piece of the proi)lcm, and then waits 
for the other task to complete it's portion. 


if (gProcessors > 1 length > kHinLengthForMP) 
i 

uint32 mid = length / 2; 


DoKemove doRemove(area, restEnd): 

DoRfisiove doRemovel (area. rest 1 End) : 

gTaskData->n(Begin “ mAreas.begin{) + mid: 
gTaskData->iii£iid = niAreaa .ead[) ; 
gTaskData->mJlewEnd = gTaskData’>mEnd: 
gTa skJ)31 a - > mFunct i on - &d o Rem o v e 1: 

// Start the other task 

KP$ignalSemaphore(gTaskData >]iiStartSeiiiaphore); 

// Do my part of the job 
AreaLlstiterator nevEnd == 
rentove_if ( 

mAreas,begin(}p 
mAreas,begin() + mid, 
doReraove); 

//TOt for other task 

HPWai tOnS emapho re (gTaakBata - >mFiixishedSemaphore, 
kDurationForever): 

) 


For further inforraation, there is an introduction to 
mulLiprocessing on the Mac in the March, 1996, issue of 
MacTech Magazine, or you can visit Apple's web .site to 
obtain Multiprocessing API in the SDK, including some 
.sample code. 

Top 20 CoivTESTAJvrs 

Mere are tlie Top Contestants for the Programmer's 
Challenge, including everyone who has accumulated more than 
10 points during tlie past two years. 'Ihe numbers below include 
points awarded over the 24 most recent contests, including 
points earned by this tnonth’s entrants. 


Rank Name 

Points 

Hank Name 

Points 

LMunter, Ernst 

218 

lO.Day, Mark 

20 

2. Boring, Kandy 

73 

ILHiggins, Charles 

20 

3. Cooper, Greg 

6l 

12.IIostetter, Mat 

20 

4. Lewis, Peter 

51 

13.Rieken, Willeke 

20 

S.Maliett, Jeff 

50 

14.Sluder, Tliomas 

20 

6.NicoEe, Ludovic 

44 

ISiiart, Alan 

14 

7. Murphy, ACC 

34 

l6,0'Connor, Tuflough 14 

Si. Gregg, Xan 

28 

17-Picao, Miguel Cmz 

14 

9.Antoniewicz, Andy 

24 




Tiiere are three ways to earn points: (1) scoring in the top 5 
of any Challenge, (2) lieing the first person to find a hug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that 1 use. Ihe points you can win are: 

1st place.20 points 5tli place.points 

2ncl place .TO points finding bug.po©mts 

3rd place...7 fxiinLs suggesting Challenge,,,2 points 

4th place...,.,,.4 points 

Here is Ernst's winning solution to the CellSelection Challenge: 

Cells^h 

© 1998 Ernst Mnnter 


r 

Sdection" 

This file is a C++ header file coniaiiiing the tk:llSclceik>ii class, as well as a number of 
auxiliary structs and classes 

The purpuse of itie CellSeJecUoa class Ls to eontaiu a set of ccLs iji a 2*0 world. Cj^Us 
can he added and manipulated in gmups represented as sets of cells, called Areas. 

Solution Strategy 

The overall idea is the same as the one J used in ilie 
-Interseciing Rectangtes" 
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diaJleng^ (dilution in MatTecht)fApr96). 

Cells are similar to black-and-white pixels, and any area a^ all-black (o£f) or atl-whiic 
(on) pixels can be represented by a sin^e hit and the 4 edge coordinates. 1 had calkd 
such a group oC pixels a ‘vixer, 

■nit CellSelection class malniains two sets of coordinates, rows and coliinin.s, anil a bit 
map of vlxcb. 

The empty selection starts t>ut with a single (off) vixel covering die area defined by 
the range of32-bif integers 0ch=^2147485fi48,top='2l474B3I^H,rigbt-2147483647, 
boitom=2147483647), 

As areas are added or removed, missing coordinates arc inserted and the total area 
becomes Hirther and further divided into su6aieas. 

Coordinate sets are stored in trees to ^cilltate easy lookup. In addition, Lliey are linked 
Ln linear lists to make it easier to traverse a span of coordinates coiresponiling to the 
edges of a given area which may be rcptest^nred by a rectangular block of man>' sub* 
3 IOS of vbtcls. 

Memoiy Management 


As row and column coordinates ate added, each is allocated by'new^, Hadi row also 
holds a pointer to ‘vixels" which are allocated with each row as needed. The deliudt 
amount of vixcl bits per row is set to 512. If more vtxels are needed as the 
t>:llScltciion giows, rows arc expanded in iucTcmoits of 512 bits. 

The bit map is not sorted riglu to left; radicr, each column struct contains an index to 
the bit-position in die vixel anay.The bits are allocated from the vixds arrays In the 
order of amval with the method calls. 

All calls to “new' are in try/cateli blocks In order to allow the test program to fall 
gracefully if we diould run out of mentor^'. 

Optimisation!) 


Basically none. 

Memory, rows and cohinius,get allocated as needed, but are only deleted when the 
CeliiseleciioQ is destroyed. Tliis will probably slow things down as the vixel map gets 
more ami more fmgmcnicd in large sclcciions. 

A future improvement could be a garbage culkcior which delects when adj3M:cni rows 
or columns are identical and can be merged. 

Aliemativcly. CcUSclcctkms could be kept in a "normaP state during each {operation by 
avoiding unnecessary' splits of coordinates, and detection erf pairs that can be merged. 

Extras 

1 have added siime public methods to the CellScfcaion class to Simplify testing: 

int CellSeleciioti; :WldLb(} 
int CellSelection:;Height(] 

return the widdi and heigh I of ihc vixcl map 

void CellSelection:tKesetTestAreasO 
bool CellSeleetlonr:HextTestArea(Area' a) 
permit stepping thmiigh the vixel map and identify 
each sub area that contains a block of cells 

I have also added a meibod to the Area simci to test for empty areas according to the 
definition. 

CLarificatfons 

Methods with rrutm type “boor (except EtfualSelectedO) return f^sc onl>^ if we run 
out of memory They' return true in all other cases, including calls with empty areas. 

The class makes no assuni]>ik)ns wludi couki rcsirirt the range of areas. SpecificaHy', 
an area with a right or bottom coordinale of 2147483647 will be handled correctly, l.c, 
we do not need a value I greater than the highest value coordinate of an area, V 

^include (siring.h> 

// needed for meiacpy and memset 

tfif _dest_os _be_QS 

elude <SupportDefs,h> 


typedef long int32: 

typedcf unsigned long ulnt32: 

jjendif 

^define EXTRA_FOR„TESTING 1 

statie const enum PtogConstsl 
kTnc ronientBlts=5i2, 
kNogInrinity=0x80000000L* 
kPoslnfinity=€x7yyFFFFFL 

// the following line avoids a compiler warning in CW PR02 
ConBts(kNeglnfinity): 


Area 

struct Area { 

intJ2 left,top.right.bottom; 

/* Area coordinates are inclusive. |2,23,4) includes 6 cdls, 7 
const bool IsEffiptyd const [ 
r Any area with lert>righl or iop> bottom is enipty'. 7 
return ((left>right) | Ctop>bottom)}; 

1: 


int32 lo; 

Node'* rtexlNode; 

Nude* leftNodc: 

Node* rightNode: 
int bal: 

Node(int32 x) i 
lo^x: 

leftNode^rightHode“nextNode=0: 
bal-a: 

I 

int32 LimitO consL 1 

tefurn (nextNode) ^nextNode >lo 1 :kPosTnfirilty; 

} 

uiiit32 Slice(int32 xlo.int32 xhi) const { 
lnt32 uppetLimit-^Liinit t): 

return l4(xhi<uppetLiiiiit?xhi:upperLi»it}* (xlo>lo7xlo:lo): 
J 


Row;Nodc 

struct Row:Nodel 

i n t size: // number of bytes allocated 

eba r * vixels; // I bit per vixd 

Rowtlnt32 x}:Node(x)l 
size=klnci:emeniBiLs/B: 
try lvisels=new char[size];) 
catch (...) (vixels=OrretunitI 
memsetlvixels*0*size): 
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Repcinlfid permi^ipri on LiFS, Inc, 


) 

ilQw(RQW* rp) :Node(rp->lo) f 
slze=rp'/size: 

try [vixels^new charlsise];} 
catch (»..} (vixels=0:return:f 
ifleffl£rpy{vixelSprp->vixels,size) j 

J 

^RowO tdelete [] vixelsj] 

Row* HextO const (return (Row*] (nextNode); ] 
tool Stretch(iiint32 index,uim32 width) \ 

//if necessary, we replace this row with a wider row 
if {width >“ size*8] I 

int newSlze^slze+klncrementBits/S; 

char* newVixels; 

tty tiiewVixels=new char[newSize] 

catch(*.*)ireturn false;] 

memc py (newVlxLel s. vixe Is, size); 

mems et(newVixels+size * 0,klncrementBits/S); 

delete vixels; 

size"newSize: 

vlxe1e=n ewVix e1s: 

) 

if (Vixel (index)} SetVixel (width) ;//dsc already 0; 
return true: 

] 

#define MEMBER vixels [index»3] 

^define BIT <lL«(indexSi7)) 

int Vixel(uint32 index) const (return MEMBER ^ BIT;] 
void Clear¥ixel(uint32 index) (MEMBER &= -BIT;) 
void SetVixel(uint32 index) [MEMBER j- B1T;1 
void InvertVixel(uintJ2 index)(MEMBER BIT;) 

/^undef MEMBER 
#undef BIT 

bool InitRailedO const [return (vixelR=0);) 

); 


CoLNode 

struct Col:Node I 

uint32 index:// bit number in evtrry row of Pixels 
Col(int32 xLeft.uint32 xindex): 

Node(xI.eft) Uiidex=xlndex ;) 

Col* NextO const (return (Col*) (nexLNode); 1 

I: 


//“Algorithms and Data Siructutc^ jd C++* 

// by Leendefl Ammendaal published by Wiley 1996 
// Here, the tree is never allowed m be empty, 

// so we dtj not have lo check for PvTUII pointers 
private: 

Node* root; 

void LeftRotate(Node* &p) [ 

Node* 

p^p->riahtNode; 
q‘> rightNode=p ^ >leftNode: 
p->leftMode=q; 
q->bal-; 

If (p-)bal)^0) q >bal —p >bai: 
p >bal“; 

if (q’>bal<0) p'>bal+=q'>bal: 

1 

void RightRotatsCNode* &p) ( 

Node* q“p: 
p=p->leftNode; 
q->leftNode-p >rightNode; 
p >rightNode=q: 
q >bal++; 

if (p->bai<0) q->bal-=p->bal: 
p->bal++; 

If (q‘>bal>0) p‘>bal+=q->bal: 

] 

int Insert(Node* &p,Node* q^Node* prev); 
Node* Find(Node* p.int x) const; 
public: 

void Clear()(root=0:} 

Node* RootO(return root:) 
void Insert(Node* q/Node* prev) t 
Insert(root.q.prev); 

) 

Node* Find(int x) const ( 

if (root) return Find(root.x); 
return root; 

I 


class CellSelection ( 
p rivate: 


CcUSclcction 


Tree 

class Tree ( 

// based on AVL balanced binary tree, sec: 


Tree rowTree: 
Row* row: 

Tree colTree: 
Col* col; 


// tree of sub-areas 

// lop most row, nc^'cr deleted 

// tree of column indices 

// left most column, never deleted 



WhM’5 THE AVERft6E 
KUNMING SPEED OF 
THE TAZMANIAN 
DOOLA'BOaA DOG ? 


8.3 niLES 
PER HOUR, 


©1997 Unitod Feature Syndiciiite, Inc. (NYCJ 



I CANT BELIEVE 
SHE KNEW THAT, 



AND YOU 
. HAVE SOME- 
THING 
STUCK IN 
YDUR TEETH. 
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u i n 13 width: // mi mber of columa% 

Hi EiTRA_FOR_'rESTlNC 
Row* tefitRow; 

Col* testCol: 

#endif 

hool CreatcEmpLy{) I 
// Creates a single vixcl covering the 32-bit universe 
roii/rree,Clear0 : 
colTree, Clear 0: 

try Irow^new RowfkNeglnfinlty) i) 
catch (.,J S return false: 1 

if (row->TnlLFailedf)} 
return false; 
row'rree.Insert(row*0): 
try tcol=new Col CkliegInflnity*0); 1 
catch (*..) {delete row; return false;} 
colTree*Insert[col*0): 
wldth^l; 
return true; 

} 

void FreeAllO [ 

// Uses linked lisis to delete all rows and columns 
Row* rp“row: 
while (rp) { 

Row* nextRow“rp->Noxt (): 
delciG rp; 
rp=nextRow: 

} 

Col* cp—col: 
while icp) ( 

Col* nextCol=cp->Wext(); 
delete cp: 
cp=nexLCol; 

I 

// and clear the trees, in pitpatnUon for re-usc 
rowTree.Clear(] : 
colTree*Glear () : 

1 

//The nm three methods expand the vixcl map by 
// lnsertk>j] of new rows and columns 

Row* SplitRow(Row* rp,int32 newTop) [ 

// Creates a new row as a copy of rp, and inserts 
// It after it, with new co(vrdinates nurking the split 
Row* nnwRow: 

try (nGwRow=nGW Row(rp);) 
catch t *. *) f return 0;1 
if (newRow->InitFailed()) 
return 0: 

newRow'>lo“newTop: 
rowTrec.Insert(newRow* rp); 
return newRow; 


bool StretchRqws(uint32 iudex.uintlS width) I 
// Allocates the next available vixel column 
Row* rp^row; 
while (rp) { 

if (!rp->Etretch{Index,width)) I 
// [f we run out out of memory before stretching all rows 
// w'e foil. Those rows that did get strctdicd stay there. 

// No harm done. 

return false: 

1 

rp=rp->Next(); 

) 

return true; 

I 

Col* SpiitColuinn(Coi* cp,int32 newLeft) \ 

// Creates a new column as i copy of cp, and inserts 
// it after it, with new coordinates mari^ the split 

if i !EtretchRovs(cp->index,width)) 


return f); 

Col* newCol: 

t ry t newC£>l=iiew Col {newLe f t * width);} 

catch [.*.) {return 0:1 

colTree* Insert(newCoIpcp); 

width++: 

return newCol; 


void 0utlineAren(Area a*Col** left,Row*' top) const ( 
// locale Top-lcfi comer closest to area. 

*top=-(Row*) (rovTree.Find(a*top)): 

*left=(Col*) (colTree. Find (a. left)): 


bool DefinoArea(Aro£i a.Col** lefi*Row** top) I 
// locate area and create new borders if needed 

Row* rp*=(Ro¥*) (rowTree.Findia. top)); 
if (tp->lo a.top) *top=rp; else 
if (0=C*top=SplitRow{i:p,a. top))) return false; 

rp=(Row*) (rowTree.Find(a.bfjttom+l)) : 

If (rp->lo !" a*bottom+l) 

If (!SplitRow{rp,a.bottom+l)) return false; 

Coi* cp*[Col*)(coiTree.Find(a.left)}: 
if (cp'>lo = a.left) *left=cp; else 
if (0={*left^EplitColuniTv(cp,a.lfift))) return false: 

cp“CCol*) (colTrec-Flndfa. rlgbt+1)) ; 

If (cp"^'lo 1^ a.right+1) 

if (!EplitColumn(cp,a.right+1)) return false; 
return true: 

} 

// The next set of methods scan blocks of vixels and perform 
// die indicated function on each vixcl 
bool SetArea(Area a) ( 

Col* left; 

Row* top; 

if ClDefineArea{s,fileft*SitGpJ) return false; 
do f 

Col* cp=le£t; 
do I 

top->SetVixeitcp->index); 
cp=cp->Next0 : 

) while ( (cp) (a. tight>=cp'>lo)); 
top=top->Next 0 : 

] while, ((top) AA (a. b<jtto]ii>=top->lo)) ; 
return Ltue; 

I 

bool ClearArea(Area a) I 

Col* left: 

Row* top; 
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if (IDefineAreaCa»fiileft,&top)) return false; 
do t 

Col* cp”left: 
do f 

top->ClearVixel(cp‘>index); 
cp“cp->Mext0; 

1 while ({cp) && (a.right>^cp*>lo3); 
top-top->Next(); 

) virile {(top) && (a,bottoni)"top'>lQ)); 
return true: 

) 

bool lDvertArea{Area a) { 

Col* left; 

Row* top: 

if [IDeflneAreaCat&left*&top)) return false; 
do t 

Col* cp"left; 
do ( 

top">IrrvertVlxel(cp*>index): 
cp"cp->Hext(): 

1 while (Cep) {a, right>"cp’>lo)); 
top=top->HextCJ; 

I while ({top) (a.bottoai>=top-^lo)): 

return true; 

) 

bool AllSelected(Area a,bool test) const I 
Col* left; 

Row* top; 

OutlineArea(a.&Ieft,&tqp); 

do ( 

Gol* ep“left: 
do I 

if {test !“ TsSet(top.cp)) return false; 
cp“cp >Next(1; 

I while tCcp) 6i6( (a. right>”cp >!□}); 
top"top-)Next(}: 

} while C(top) && (a.bottont>’=top->lo}); 
return true; 

I 

Uint32 CourHSclcctodP(Area a) const I 

Coi' left ; 

Row* top: 

OutllneAreaCa.&left»itop): 
uint3?. count-ti; 

do [ 

Col* cp=ieft; 
uint32 strlp=0; 
do I 

if (IsSet{top*cp)) strip-^cp->Sllce(a-left*a*right): 
cp-cp->Kext(); 

) while {(cp) && Ca.riglit>=^cp’>lo)): 
count+"strlp*top->Sllce(s- top.a,bottoni): 
top^top >Next(); 

I while {(top) (th (a*bottoin>”top >lq))r 
return count: 


bool TsSet(Row* rp,Col* cp) const! 
//Tests if 3 vixd is set. i.e. if the ceils repfesemed 
// by the sub-atea definrd by 1 row and 1 column^are 
// m die (kltSclecUon. 

return rp‘>VixelCcp->iiidex); 


public; 

CellSelectIon(void) I 

r crcaic an empty selection 7 

CreateRjnptyO ; 

#tf mftA_FOH_TESTING 
testRow“0: 
tGstCol"0: 

#endif 


1 

“Ce11Sele c tion(void) f 
r free any alkKatcd memory V 
FreeAllO; 

1 

bool Clear0 [ 

/* mak e the sckclion empty */ 

FreeAllC): 

return CreateEroptyO; 

1 

bool Add(Area area) { 

r add the area of cells to this selection 7 

if (larea.IsEiflptyC)) return SetAreaCarea]; 
return true; 

] 

bool Remove(Area area) I 

/* remove the area of cells hum this selection 7 

if (Jarea. IsEniptyO ) return Cl ear Area (area}; 
return true; 

J 

bool Invert(Area area) ( 

/* remove cdls in the area that are also in this selection 

and add the area cells that are not In this 
selection */ 

if (larea.IsEmptyC)) return InvertArea(area): 
return true; 

) 

bool Add(const CellSelection otherSeiection) [ 

/* add the othefSclection to this selection 7 

Row* rp==^gtherSelection,row: 
do I 
Area a; 

a. top=rp - > lo: a. bottonj“rp - t C): 

Col* cp-otherSelection.col; 

do ( 

if (lsSet(rp,cp)) ( 

a.left=cp->lo;a. rlght“cp C): 

if (ISeiArea(a)) return false; 

J 

cp“cp->Next0; 

1 while (cp); 
rp^rp >Next{): 

1 while £rp): 
return true; 

) 

bool Remove(const CellSelection & othecSelectlon) ( 

f remove the iStherSeleoion from this selection 7 

Row* rp=otherSelection.tow; 
do 1 
Area a; 

a. top-rp - >lo; a. bottomTp - >Liait (): 

Col * cp“otherSelection.col; 
do 1 

if (IsSet(rp.cp)) ( 

a.le£t=cp’>lo;af tight^cp >Hmlt (): 
if [tClearArea(a)) return false; 

1 

cp”cp->Next () I 
1 while (cp); 
rp=tp >NGxtC); 

I while (rp); 
return true; 

) 

bool Invert(const CellSelection b otherSelection) [ 
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return false: 


/* remove cells In the othcrScJettion tliai are also In this selection 
and add the otherSeleciion ceils chat are not in this selection V 


1 

#Gndif 


Kow* tp=otherSelecLion, row: 
do f 
Area a; 

a. top=tp' >lo: a. bottom-^rp -)Limit (); 

Col* cp^otherSelection.col: 
do I 

if [IsSet(rp.cp)) [ 

a. left=cp >lo: a. rl ghfe p ^ >Liinit () : 
if (IInvertArea(a)} reIurn false: 

) 

ep=cp->NeK:t C): 

] while (cp): 
rp"Tp >Next() ; 

I while (rp): 
return true: 

I 

bool AllSelected(Area area) I 

f return TRITE if all ceils in the area are selected V 

if (area.lsEmpty()) return false: 
return AllSeloctcd{area,true); 

) 

Uint32 CountSeiected(Area area) f 
r count cells that are “on''7 


#ifndef CELLS_I>KF1H1TI0NS_TNCLUDED 
^define CELLS^DEFlNITXONSaKGLUDEU 

//We avoid Inlining of recursive mcUiods 

int Tree::Insert (Ifode* &p.Node* q.Node* prev) ( 

// insert node q in (sub-)tree rooted in p 
int deltali=0: 
if (p^O) \ 

p=q; 

deltaH-1; 

// also Insert q in linear list, foliowit^g prev 
if (prev) I 

p->nextMode^prcv >nextNode; 
prev‘>nextNode=p; 

I 

] else if {q->io > p->io) [ 

if (Insert(p‘>rightNocte,q.prev)) f 
P'>bal+i: 

if (p->ba1=J) deltsH-l: 
elue if (p >hal-*2) t 

if (p‘>rlg,htNodG >bal”" 1) 

RlghtRotate (p->rightWodG): 
leftRotate(p): 


if (aroa.IsEmptyO) return 0: 
return Count Solected P(a rea): 

I 

bool EqiialSelected(const CellSclGCtion & otherSelection) 

r return TRUE if othcrScIecilon equals iliis sekaion 7 

Row* rp”row: 
do I 
Area a: 

a, top=rp - Mo: a, bottomrrp )Liro i t (): 

Col* cp^col: 
do { 

a.left=cp->lo: a .right^cp->Lirait(); 

If (!otherSeIeetion.AllSelected<a-IsSet(rp^cp)]) 
return false; 
cp=cp->NGxL(); 

\ while (cp): 
rp^rp">Kext0; 

\ while (rp); 
return! true: 


/Hf £XTRA_FOH_TESflNG 

const int Width{) const (return width;} 
const int HeightC) const [ 
int h=0: 

Row* rp=row: 

while (rp) {h-H-jrp^rpONextO : 1 
return h; 

1 

void ResetTes tAreast) I 
testRow^row: 
testCol=coi: 

} 

bool HextTestArea[Ares* a) f 
while (testRow) l 
Row* rp“testRow: 
while (test Col) I 
Col* cp=testCol; 
teatCol-cp ->llexi (): 
if (IsSet(rprcp)) [ 
a->left'“cp->lo: 
a'>top=rp-)io: 
a->right=cp->LiiDit (): 
a >bottoiii”rp->Liiiilt(): 
return true: 

I 

testRow^rp->Next(); 
teetCol=col; 

J 


t 

] elso if (q->lo < p->lo) \ 

if (Insert(p >leftNnde.q.prev)) I 
p->b3l-: 

if (p->bal=-l) deltall-1; 
else if (p->bal=-Z) I 
if (p->leftKode->bal=l) 

LeftRotate(p->leftKode); 

RlghtRotateCp); 

I 

) 

1 

return deltaH: 

1 

Node* Tree::Find[Node* p,int x} const I 
// find nearesi p'>lo <= x 
// never returns a ^^iTTl pointer 
if (p->lD<x) l 

if (p->rightNt)de) ( 

Node* q-Rind{p->tighlNode,x): 
if (q’>io<=x) return q: 

1 

] 

il (p >lo>x) ( 

if [p >lofLKode) return Findfp->leftHode.x); 

I 

return p: 

J 

ifendif 

m 
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continued from page 57 

How can you obtain the SUIO for a class at nintime to 
determine compatibility? First, query the Virtual Machine for 
information about the class represented in the stream, usin^; 
methods of the class ObjecIStreamClass. Mere is how we can get 
the SUID of the current version of the class named MyClass, as 
known to the Virtual Machine: 

ObjectStreamClass myObject * ObjectStreamClass,lookup( 

Class.fotNarae{ “MyClass" ) ): 

long tbeSUlD = myObject.getSerialVersionUID ( ) ; 

Now when we restore an Externalizable object, we can 
compare its SUID to the class SUID just obtained. If there is a 
mismatch, we should take appropriate action. This may involve 
telling the user that we cannot handle the restoration, or we may 
have to assign and use some default values. 

If we are restoring a Serializable object, the runtime will 
check the SUID for us when it attempts to read values from the 
stream. If you override readObjectO, you will want to compare 
the SUIDs there. 

How do you determine what changes between cla,ss 
versions are acceptable? For an earlier version, which may 
contain fewer fields, trying to read a serialized object from a 
later version of the same class may cause problems. There is 
a tendency to add fields to a class as that class evolves, which 
means that the earlier version does not know about the 
newer fields. In contrast, since a newer version of a class may 
look for fields that arc not present in the older version, it 
assigns default values to those fields. 

This can be seen in the example code when we add a 
new field to the MyVersionObject class, but don’t update the 
SUID. The new class can still read the older .stream 
representation, even though no values exist in that stream for 
the new fields. It assigns 0 to the new Int, and null to the new 
String, but doesn’t throw any exceptions. If we then increment 
the SUID (from 1 to 2) to indicate that we do not consider 
older class versions compatible with this version, we throw an 
InvalidClassException when attempting to read a version 1 
object from the stream. 

The Sun documentation lists the various class format 
changes that can adversely affect the restoration of an object, A 
few of these include: 

• Deleting a field, or changing ii from non^static or non- 
transient to static or trarLSient, respectively. 

* Changing the position of classes in a hierarchy. 

* Changing the data type of a prirtiidve field. 

• Changing the interface for a class from Serializable to 
Externalizable (or vice-versa). 


On the other hand, not every change will have a negative 
effect. Here are some changes lo class versions that do not have 
a detrimental effect on object behavior: 

• Adding fields, which will result in default values (based on 
data type) being assigned to the new fields upon restoration. 

• Adding classes will still allow an object of the added class 
to be created, since the class structure information is 
included in the stream. However, its fields will be set to the 
default values. 

• Adding or removing the writeObjectO or readObjectO methods. 

• Changing the acces.s modifier (public, private, etc,) for a field, 
since it is still possible to assign a value to the field, 

• Changing a field from static or transient to to non-static or 
non-transient, respectively. 

Format of a Serialized Object 

'the format for the default structure of a serialized object 
i.H .similar, but not identical, to the structure of a class file. The 
Sun documentation describes in detail the format of the 
Object Serialization Stream. The example code writes files 
that may be opened with a text editor, so you can inspect the 
serialized oirjecis. 

Example Code 

The following code illustrates the writing and reading of 
Serializable and Externalizable classes. ObjectReadefWriler is 
the primary application class. At runtime it displays a "Save 
As.,." FileDialog, allowing you to specify an output file to 
receive the stream containing the serialized objects. (All the 
sample objects are written to the same file.) It then prompts 
for an input file from which to read a stream. 

This arrangement of the sample code allows you to write 
out the serialized data to one file, make changes to the clas.s 
format for one or more of the data classes, recompile and 
rerun, and attempt to read one of the older versions back in. 

The class MySerialObject contains a reference U> an 
instance of the class MyInternalObject. to demonstrate the 
saving of nested object references in the stream, 
MySerialObject also contains a field (of type int) that is 
marked transient, and upon restoration you will find that the 
default value 0 gets assigned to that variable. 

The clas.s MyVersionObject demonstrates the use of 
versioning with a programmer-specified SUID. You only need 
to change the SUID when you make changes to the class 
structure that render it incompatible with older versions of 
that same class, and whose serialized instances have 
previously been written to disk. 

You can compile the .java (source) files using the javac 
Qava compiler) Lool included in the MRJ SDK Tools folder, or 
using the Java compiler in Code Warrior or Visual Cafe, You 
can then optionally create a .jar Qava archive) file containing 
the resulting .class (output) files. 
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The archive for this article includes the .java and .class 
files, anti a .jar file containing the .class files. *lb run the 
program, drag either the file ObjectReaderWriter.class or 
ObjectReaderWriter.jar onto the JBindery application icon, which 
is located in the MRJ SDK JBindery folder. Once JBindery 
launches, it will display ObjectReaderW rite r in the Ma.ss name” 
field. (This field specifies the name of the class to run at 
application startup; that class must contain a fnainfl method.) 
Click OK to mn the program. 

listuig h ObjectReaderWrUerJava 


ObjcttReadcrWriicr.java 

cUas diat will rc^ siitd write ^rbJl/ed and eternal i/jcd objeeb. 

import java*avt.“; 
import 

public class ObjectReadertfriter f 
Siring filcPatb; 

public static void italuC String args[] ) I 

ObjectReaderWtiter orw * new ObjeetKeadurWriterO: 

) 

ObjectReadftrWtiterC) t 
try I 

// Create insiMrcs of eadi data ckss to be serialized. 

MySerialDbJect sorialObject = nsw MySerialObJectO: 

MyExternObJect extemObject new MyExternObject{); 

MyVsrsionObject versionObject = new HyVersionObJeetC): 

// Allow tlic user to specily an output file, 

FileDialog fd ^ new FneDlalogi new Fraifle{h 
"Save As**.", FilcUlalog.SAVE ): 
fd .sbovO: 

filePath » new Stringi fd.getDirectoryO + fd.getFtlG() ): 
// Create a stream ft>r wriimg. 

FilGOutputStreaBi fos = new FileOutputStreamt filePath ); 

// Natt, create an obfea that can write to that file. 

ObjectOutputStream outStream ^ 
new ObjectOutputStreutti fos J; 

// Save cadi objeel, 

outStreao.writeObjGCtC serialObject ): 

exter£iObjoct*writeExternal( ovrtStream )i 

outStream.writeObjectC veisionObject }: 

// Finally, we call die nushO meihod for our object, which forces the data to 
// get written to the stream: 
outStreaia.fliJah{) i 

// Allow the user to specify' an input file, 
fd “ new FileDialoftJ new EraroeO. “Open..."* 
meDiaiog.LOAO T: 
fd*show(): 

filePatb - new Striiig( fd.getDirectocyO + £d*getFiie() ); 
// Create a stream ft>r reading. 

FilelnputSiream fis new FilelnputStreamt filePath ); 

// Mdl, create an object that can read from that file. 

Object Input St ream inSUeaia = new Object Input St ream C fis ); 

// Retrieve the Semlizabk objecu 

serJalGbject “ ( HySerialObject JinStream^readObjectU ^ 


// Display what we retrieved: 

SystGM.out .printin( setlalObject.getSO }i 

Systum.out.println( "i + serialObject.getl£) )r 

serialObject.displayInternalObJectAttrs 0: 

// Retrieve the Exteiitaliziblc objea. 
externObjsct*r€ad£xternai( inStream ): 

// Display what we retrieved: 

System*out.println{ externObject.getS£) ): 

System*out,prlntiii( -i - + externObjoct,getl() 

// Retrieve the versioned objcci. 
versionObject “ £ MyVersionObject ) 
inSt ream.readObj ect[): 

// Display what we retrieved: 

System.out,print In £ versionObject*getSC) )i 

System. out * printlnC **i * “ t versionObject. getl () ): 

// Display the SUID of the versioned class ki the VM, 

// not necessariJy the srriiUred object. 

ObjectStreamClass myObject ObjGctStreamClass.lookupf 
Clusa.forNameC "MyVersionObject" ) ): 
long theSUrO - myObject.getSerialVerBionUlDO; 

System.out.pcintln 

{ "The SDID of class MyVersionObject * " + theSOTD ); 

1 

catch ( TnvalidClaseException e J 1 

SysLejQ . out * prlntln( "InvalidClassException *,." ) r 

I 

catch ( ClassfiotFoundException e ) I 

System.out.println £ "GlassMot FoundException * *," ): 

1 

catch ( OptionalDstalxceptlon e ) i 

Sy g r.eri * out. println ( ‘'OptionalDataException ♦,. * ) t 

I 

catch { FileNotFoundException e ) I 

System,out-println£ "FlleNotFoundExceptlon..): 

] 

catch ( lOException e ) [ 

System.out * println[ “lOExc eption *.*" ): 

1 

] 

I 


listiag 2: MySenalObject^j^va 


MySerizIObject.java 

The i^crializabk data class. 

Import Java.io.*: 

public class MySerialObject Implements Serlaliaable ( 
private transient int 1; 
private String s; 

MylnternalObject mio; 

MySerialObject() { 
i * 64 j 

s “ new String( "Instance of MySerialObject ..)i 
mio = new HyIntermlObject (); 

1 

public int getrO 1 
return i: 

1 

public String geiS£) I 
return s; 

I 

public void displayltiterualObjectAttrsO t 
System.out-printlnf iiio,getS£) ): 

System-out-println{ "i - " + mio.getlO ): 

1 

) 
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Listing it MyliiternalOblecLjava 


MylntcfnaiObjcci java 

The nested data class, 
import java.io-*; 

public class MylnternalObjcct itBpletnents Serializable I 
private int i; 
private String, s: 

MyltitemalObjectO I 
i - 128; 

s new String{ “Instance of MylnternalObject,.." ): 

public int getiO 1 

return 1: 

1 

public String getS() 1 
return s: 


Listing 4: MyExternObjccLjava 


MyExtcrnObjcct java 

Thff extcmalizable data class 
import java.io,*: 

public class HyExternObject ImplementB Extarnalizable I 
private int i; 
private String s: 

HyExternObjecl() I 
i = Ibb; 

3 = new String! “lastance of HyExternObject.»." ): 


public int getlO I 
return i: 


public String getS() ( 
return s; 

] 

public void wrl tcFictcrnal I ObjectOutput out ] throws 
lOException f 
out.writelnt! this,! J; 
out-writeObject[ tbis.s ): 


public void readExternal( ObjeetTnput in ) throws 
tOExcaption, CinssNotFoLmdExcepLion I 
tbisJ ~ in, rcadJnt (); 
tills { String ) in. readObjectO : 

1 

) 


Listing 5: My Vers ionObjecL java 


My VcrskuiObjecl. java 

The versioned data class, 
import java.io.': 

public class KyVersionObject impleinents Serializable 1 
static final long aerialVersionUTD = LL; 
private Int i: 
private Siring s; 


// l;nconiment the next twti lines to verify that default values will be substituted if 
// the value is not prefsttt in the stream at deseriahsm^tion time, 

// private int i2 = - I; private String s2 = "This is the new String field'"; 

MyVersionObject!) [ 

i = 512: 

s new String! “Instance of MyVersionObject.* *" 1: 


public int getlO I 
return i: 

I 

public String getSO f 
return s: 

I 

] 

Conclusion 

Adding object persistence to Java applications using 
serialization is easy. Serialization allows you to save the 
current state of an object to a container, typically a file. At 
some later time, you can retrieve the saved data values and 
create an e([uivalenl object. Depending on which interface 
you implement, you can choose to have the object and all 
its referenced objects saved and restored automatically, or 
you can specify which fields should be saved and restored, 
java also provides several ways of protecting sensitive data 
in a serialized object, so objects loaded from a serialized 
representation should prove no less .secure than those 
classes loaded at application startup. Versioning provides a 
measure of the backward compatibility of cla,ss versions. 
The code needed to add .serialization to your application is 
simple and flexible, 

Referejncls 

Developing lava Beans . Robert Englander, O’Reilly ^ 
As.scjciates, Inc., 1997. 

LUtls 

• <http://www.javasoft.eom/produds/jdk/l. l/docs/guideyserialization/ 
index.html>. 

• <http://www.apple.com/macos/java/>, 
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TIPS & 
TIDBITS 


by Stet>e Si^ak 



It is easier to <|uit an app than to close a window tic'cause 
the eltxsc window event requires a direa object and a (x>sition 
descriptor to indicate which window. Quitting an app simply 
requires creating a cjuiL event and sending it, 

Tfic following code takes a valid target desc (which Tin 
assuming you already know how to create) and sends a close 
first window event to I fie app stKxilled in that taiget desc. 

The code is modified from similar code I used a while l>ack. 
I inay fiave made some errors in removing stuff or changing 
identifiers, hut it should give you tlie right idea, f eel free to e- 
mail any questions aljout it, 

void GloBcFrontWindowOfApp( AEAddressDesc * theTargetDescF^tr 1 

t 

AEDeso f ron t Wind owOb J S pec t fie r: 

AppleEvent event; 

AppIeEvent reply; 

OSRrr err = noZrr; 

//itiltializr ikscriptoni 

event,descriptorTypi? typeNull: 

reply,descrlptorTypq typ^Null; 
frontWindowObjSpeclfier idcscrIptorType = typeKiill ; 

event.dataHandle = NULL; 
reply*dafflHandle = NULL; 
rrontWindowObjSpeelfier,dataHandle = NULL; 

//crcaic objcci j|jcc for fnmt windnw 

err “ J1yCreatei!r<jutWindow0bjSpee( &frontWlnd<wObjSpecifier ) ; 
if ( err J 

goto CLEAMJP_SetBounds; 

//create apple event- not Jiurc if dose evetii Is in kALCoEcSoltc? 

err “ AECreatcAppleRvent( kAECoreSuite, kAEClose, 

L b cTa r ge t De Br Pt r * kAut oGene ra tetter n r n 1D» 
kAnyTrartsact ionTD, tevent ); 

if ( err 1 

goto CLEANUP_SetBounds: 

//insert ditect into ac 

err ” AEfurFaraDiDeact tevent, keyDirectObject, 

StfrotitWindowObjSpecIfter ); 
if ( err ) 

goto CLlANUP_SetBounda: 


//di$po«ie ckscriptora 

CLRANlIP^SerEounds:: 

AEBiapoEoUeBc (kevent): 

AEDlupoBcUosc (fereply); 

AEDiapoeelloBC C^froniWlndowObjSpecifier); 

I //end function 


OSKrr MyCroatflFrontWiodo^bfSpec { AK&eac ‘frofitWlndowObjSpee ) 
I 

AEDesc eToptySpp-cifier; 

AEDesc positionUesc; 

long thePosltlora; 

DescType propertyType: 

OSKrr err; 


//uiiilill^c dfst riptors 

enptySpecifier^dosrrIprorType = typeNull: 
positionDesc.descripiorTypc * typeHull: 
propertyDesc.descriptorTypc ^ fypeNull; 

cDipiySpecifler.dataliandie NULL: 
positionDenc*datsRandl€ NULL; 
propertyDesc.dntaRandle " NULL; 

//cTcaic objSiKdfitT for window I of null container 
thePosition = l; 

err =* AEGreateOesc ( typeLongltiLogor. [Ptr) EAthePoaition), 
elaeofE theFositiori ), ApostttonDesc); 

If ( err ) 

goto CliKANtrT' MyCrcateBoutidsObjSpec; 

err * CreateObjSpecifier( eWindow, 

ioiiptySpecif ier, 
r 0 rmAb aol u f e Po a it i o n * 
StpositionDosc, 
false, 

frontyindovObjSpcc 3 : 

if E err ) 

goto CLEANUP.MyCreateBoimdsObjSpec; 


//dlspiKst; dcM-riptoTN 

C!.KAN1IP MyCreateBouQdsObjSpec:; 

AEfllspoaeDesc (&’windowObjSpecifier); 
AHDlsposeDe.Bc (Apositionbesc); 

retum err; 


//send ae 

err - AESetid{ Sevent, &repiy< kAENoReply + 
kAENeverInteract + 
kAECanSwii chltsyer, 

kAENorsmlF rlor 11 y, kAEDefaultTimeout, 
kNoidleProc* kNoFilterProc ): 


Daiid T I^rson 
dtp^pluto. njcc. com 

m 


t us your tips or welt insiati nL^iBetterBusError on your machine/ Ofi the other band, ue might just pay you SIS for each tp we use, or $50 ^ 
for 'tip of the Month. Phri can take yimr atmnd in goods, subscriptions or US$, Make sum any code compiles, and send tips (and. where to mail 
to our Ups e-m^l add/ress at iips^tnactech,s:^om. (Seeptme I for mar other ctddtesses,) . *; ^ - 
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MACTECH 

ONLINE 


by Jeff elites <online®inactech.com> 



Whoever fust said, “Its a small world," must not have been 
shopping for a database. There is a lot out there, probal^ly Ixxrause 
the idea of a database is one of the most fundamental and 
powerful concepts in computing. After all, what do computers do 
if not manipulate, store, and retrieve datai^ At its simplest, a 
database can lx," just a file system. On another level, it can be a 
mechanism for providing object persistence. And on a larger scale, 
it can be a repository of information to be accessed remotely from 
thousands of locations and multiple platforms. To help make sense 
of it all, we're going to take a quick tour of this vast landscape. 
Sinc^ several of the big tourist spots are reviewed elsewhere in this 
issue, we'te going to visit a few of the more intimate, out of the 
way spots tliat might otlierwise be missed. 

Don't Forget to WRni; Home 
As widt all trips, it can be 5uq>rising how many things tfiere 
are to see right at home ™ and in this case, home is Apple, 
Developer World has an extensive list of pro^JuL^s available for 
the Macintosh for client/server and database development. It's 
over a year old, l)ut still provides a wealth of information about 
just what is out there, and it gives brief explanations of some of 
the terminology involved along the way. There is akj the 
MacODBC SDK, which uses a shared library to provide a 
generalized API for interacting with databases. 

While you're in the Apple domain, stop by the AppleScript 
site, where there is a tutorial on database publishing. They use 
FileMaker Pro and QuarkXPress to demonstrate how AppleScript 
can be used to bring llie servic’cs of a database to another 
scripiable application. It's a good place to start convincing yourself 
that AppleScript really can be used by serious developers. 

Here's one of the best kept secTets of the Mac OS: Apple has 
cautioned developers that the resource manager is not a databa,se. 
But, then they “thought different" and provided the Dictionary 
Manager, which is. It's designed to provide a reusable format for 
dictionaries used by input methods for 2-bytc script systems, but it 
can also be used for other lightweiglit database tasks. If you can 
handle its restriaions (keys at mexst 129 bytes, records at most 4096 
bytes, and a total database of less than 16MR) or are just gening 
your feet wet with database programming, tlien it can pnwide a 
simple, free, and always available alternative to third-party 
packages. It's documented in Inside Macintosh: Text. 

Client/Server and Database Development Tools for the Macintosh 

<fntp://de vTools.appie.com/general/Guide2M3CTools/csdatabase.html> 

Apple Software Development Kits 
< hi T p : // de vwn r I d. app I e.c o m /ng s/I pp/a d rpu b/ d ocs/dev/sdk.html> 

Database Publishing Lessons 

<http://applescT ipT. apple.coiTVapplestdpt_oveiview/dbase_le 5 Son 5 /DBASE_.L£SSON.OO.HTM 

The Dictionary Manager 

<htt p: //ge m mu. apple, co m/iiev/ (ec hsi ippor t/insidem ac/Text/Texi-4B3. htm 1> 


MAcTt'Qt Online 


Learn the Language 

The database market comes with its own set of lingo and 
acronyms. If you're a little befuddled by terms such as SQL, 
ODBC, DBMS, and 4GL, then the Free On-line Dictionaiy^ of 
Computing can help. 

But when you want to start getting down to serious business, 
it’s lime to leam the to talk directly to your database — like a 
native. Fortunately, there is a standard language, which Is used by 
many (but certainly not all) txxnmerdal databases. It's SQL, the 
Structured Query Language, and it's spoken by the big boys, 
Orade, Sybase, and Infoniiix, a.s well as by others. For the brave, 
there \s an online tutorial and an FAQ, but die most useful 
resource may lx: the “Ask the SQL Pro” site, wliich can help 
answer your questions as you learn the language. 

Free On-line Diaionafy of Computing 

< h t ip://wf n-sh 0 p. p ri nceton. od u/eg i - bi n/t 01 d 0 c .-> 

SQL Tutorial 

<btip://w3.onenet/-|hoffma[i/sqltut,htnfT> 

SQL FAQ 

<http://epoch. C S. B er keley.EDU:8000/sequoia/d ba/m ontage/FAQ/SQ L_T0C .html> 

Ask the SQL Pro 

<hltpMwvm. i nquiiy.com/tediti ps/thesqlpro/ > 

Planning YotiR Next Trip 

'Ihere are two tilings certain to lx‘ in the future of any Mat- 
programmer: Rhapsody, and Java. You ain’t hide from tlieni forever. 
Fortunately, Ixilh come rtrady-made to interact with database 
serveis. Rhapsody has the Enteqirisc Olijecis Framework, whkJi 
allows your applications to interfece with relational dataliases, and 
which most notably allows WebObjects applicarions to interact with 
a database in an objea-oriented manner. Rhapsody Ls also slated to 
ship with a free version of tlie OpenBase SQL datalyasc engine. 

Ft)r Java developers, life is good, because there is an SQL 
database interface which form.s a standard part of Java, and 
which is included in the JDK l.L It's tlic JDBC API, and you can 
find out all about it on Sun's Java site. 

Documentation for Internet/Enterprise Programmers 

< http: .//g emm a. a p p k. c.oni/T<?{; h I n t o/tet hdo e;s /e nt er pr (se/e n t er pr i se. htm l> 

WebObjects 3,5 Documentation 

<http: //gemm^.tipple.cQm/Tefh in Iq^'tpc hdoi s/en t Hq j£ ise/WebObjea s A/VebObjectsTDC iitrnl> 
Creating a WebObjects Database Application 

< http://gem nrta.applc.com/tcch I nfo./TGchdocs/enterpr I se.Web01))eds/GetlingSianed/M 
ovies/MoviesTOChtmb 

OpenBase international. Ltd. 

<http: //www.openbase.com/> 

The JDBC(tml Database Access API 
<httpi//]ava.sun,com/produas/jdbc/indexhtnii> 

These and otlier links are available from the MacTecJi 
Online web pages at <http://www.madech.com/onfine/>. Kl 
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Mt. BusBnof cBuses $ BusBrnt If foo detefetenee BIL BtenBeHetBusBtMf unit B0tesBa$Bftot 
Impmed oa fhh feaiute, pmidiag a BasBnof If fou wtlfe to a MIL poinfet ot execafe code 
at MIL. 7 be BeuBatBtm fops fhom all... Ifpmides a BusBftot oo maffet 90a do! 

Ask us ahaiit the BestBusError Demstalier Kit! t~SOC^555~3665 
<http/A^Ht>ze^MacTec!hconi/BestBusEiror/> 


"It has doubled the number of bug reports ive receive!" 
- Poyu T. Haifrd-Boss 


"Please don't crash, please don't crash,,," 

- Nick DeMello (Beta Tester) 

"One of the most memorable products we have 
ever reviewed." 

- MacTech Magazine 

"I love the new random timer feature!" 

- April F. Ool (Quality Control Manager) 


For a limited time only: 

$99 

Offer expires April 2nd 1998 


"It does suck," 

- Rich Siegel (Author of BBEdit) 


Coming In April '99 Version 2,0 with Quit Function! 
Windoivs version unnecessary! 

Great as a gift! 


Unclear Concept Software Inc. 

Makers 0f**the System Uitinstaller** am! *^DiskDeleter** 







by Jessica Courtney 


S'n)NE Desi<;n and Caffeine Software Deuver the 

ENHANC^J LIC.ENSER KTT 

Long time NeXlSlTiP/OPENSTEP/Rhapsody developers, 
Stone Design Corp, makers of Create, and Caffeine Software, 
makers of TIFFany, announced today that thetr acclaimed 
Licenser Kit has been updated and imprtwed, and fnnjre 
upgrades of the kit are free, at least until the year 2()0L 

The Licenser Kit allows developers to quickly add the level 
of copy-protection security tliey retjuire, including the following, 
combinable options for generating rcstrictc'd usage: 

• Tie license to user name. 

• Tie to host ID (now including Windows 95/NT!) 

• Create floating netwrirk licenses. 

• Allow as many users as desired. 

• Have unlijiiiled nymlx:r i>f licenses on a network, 

• Add licenses on the fly (cumulative licensing). 

■ AuKimaiically iinficense if application is moved or copied. 

■ Generate expiring licensers for “full strength” demos. 

■ Automatiolly track liie licensee cumenLly in u.se on the network. 

• Fully customizable through subclassing and ittterface files. 

• Only you know the encryption code for your apps, 

■ Full source for License Generation app incliKled. 

• Royalty free. 

• Free upgrades at least until 1/1/2001, 

The Licenser Kit his l)een in development and testing for 
{)ver five years by Caffeine Software and Stone Design, and is the 
choice software protection .solution for all the top Rhapsody 
developers, including Anderson Financial Systems Inc,, PScl 
Systems Ltd., OneStep Sr>lutions Pic,, Jenike ik Joiisanson, Inc., 
Robert Vasvari, and other not yet publicly disclosed Rhapsody 
and YellowBox developers. 

Added to this release is a network license monitoring system 
that ]>ermiLs users to see who is using the same application, 
which is very helpful when all of the licenses are already in use. 
'i'he people using the licenses and die machines ihL 7 are using 
diem on are automaticaliy listed in the Liceo.ser Kit panel. 

Another new' feature is the ability for a software house to 
have licenses genemted for one application that can he used in 
ant)iher application, but not vice-versa. Tills conics in handy 
when developers offer a "pm" product along with a “companion" 
application, for example. 

The Licenser Kit Is available now for Rliapsody Developer 
Release, Apple YellowRox for Windows, OPENSTEP 4,x. 
OPENSTEP Enteqmse for Windows and NT, and NeXTVrEP. 
Unlike competing products, Tlie Licenser Kit support,s network 


floating licenses, where a license can be instafled on the network 
and shared by all users, which gives tfic developers better copy 
protection control and is extremely end user friendly. The 
floating licenses are well suited for site licensing. Moreover, tlie 
Licenser Kit enables users to purchases an initial number of 
floating licenses, and later increase this number using the Kit’s 
cumulative license strategy. Of course, expiring (timebomb) 
licenses can l^c generated cm the fly by the developer for fully 
functional demonstrations, 
http://www.stone.com/Licenser/ 

ACI Product Une v6.0.5 

less than a year after the release of its major produa upgrade, 
4lh Dimension version 6.0, ACI has engineered a significantly 
enhanced version ft)r the entire ACI Produd Line ™ version 6.0.5. 

The benefits provided by this maintenance release include 
improved functionalities and an extremely stable and robust 
design environmcni. ACI Prcnlua Line version 6.0.5 is proof of 
ACPs commitmeni to providing t|ualily development tools to its 
7,000-strong develoj^er community. Version 6.0.5 also includes 
.some new teatures, .such as new management of picture field 
compression, and a new prcx:edure for converting 4D version 3 
applications to 4D version 6, 

The success of 4th Dimension version 6.0, released in 
early 1997, can be measured by the large proportion of 
professional developers who have already upgraded to this 
new version to build powerful cross-platform applications. 
Among the highly acclaimed features of 4th Dimension and 
4D Server v6 are a built-in Web server, a revamped interface, 
triggers, stored procedures, a visual, interactive debugger, and 
an object-ba.sed forms editor. 
http://www.aciLis.com 

FmrCom Releases New Version oe otree Pijus, V6JA, for 
Macintosh with Conditional Index Supkiri, Transaction 
History, Variable Length API 

FairCom Corporation announced the latest release of c-tree 
Plus v6.7A file handler and the FairCom Server for the Macintosh, 
mduding support for System 7,X and Mac OS 8.X for both Native 
PowerPC and 63K. TTiis new release of FairCom's C ISAM 
database API offers an enhanced variable length API resulting in 
easier and faster variable length record operations and 
conditional index suppi^rt, which pn^vides a means to define 
complex expressions and use them to filter the entries within an 
index. Other majf)r features of this release include a transaaion 
history function, wliich makc.s it po.ssible m acx:ess the audit logs 
of transaction controlled files. 
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Developer Central" 


“The Place for Macintosh Developers 


Sponsored by 




And 


Worldwide Developers Conference 


(WWDC ) 


IVl AY 11 - 15, 1998 

San Jose Convention Center 

At Developer Central, you can... 

Talk directly to representatives from Apple and third-party vendors 
^ Demo developer products and tools 

^ Get the best deals on tools, troining, and developer resource materials 

So, no matter if you're developing a departmental system, developing 
plug-ins for the Internet, or planning the next great Mac OS application 
or multimedia title, you'll find vrhat you need at Developer Central. 

http://www.devcentral.com 


Apple, rile Apple logo, Moa'nto^, Moc, ond ftie Moc OS logo oie registered trodemorks of Apple Computer, Int. Developer Centrol, 
Virtual Developer Central ore trodemorb of Apple Computer, Inc. MocTech is o registered trademark of Xploin Corporation. 




The new release of entree Plus also provides conditional 
index support, which aUows indices U> lx; defined at die data 
content level rather than at just die field level Dynamic index 
(select/omit) filtering am be performed on c-tree Plus index files 
by using a powerful expression par.ser/analyzer. Complex 
expressions are defined and evaluated at run time to control 
index entries, resulting in smaller, liighly efficient indices 
groomed to a developer’s precise neetls. The conditional index 
support is available in all seven c-tree Plus operational modes. 

The transaction history function allows for the accessing of 
the audit logs of transaction controlled files. This enables the 
progmninier to scrutinize the changes performed on each unit of 
information at a very detailed level. One such use of this 
technology has been lo track the changes made to a manufactured 
device as it proceeds through an automated fabrication factory. 
Tlie exact individual history of each manufactured device can be 
determined from the traasaction log files. 

Additional features of version 6.7 of c-iree Plus include: 
ISAM access enhancements, batch performance, sysiem 
configuration function and transaction processing enhancemenis- 
new extended perfomiance monitor; and file path control 

FairCom created Access Manager for l>igital Research in 
1979 and released its first tnie application development tool, the 
original c-tree file handler, that same year, foday c-tree Plus Is 
running in over 100 CPU/OS environments in more llian 98 
countries worldwide. FairCom Macintosh implementations are 
utilized by such noted organizations as: McGraw-Hill, FoIIett 
Software Company, Great Plains Software and Phone Directories, 
Cx>rporaijoiis like Computer Associates and Sharp Corporation 
have eml)edded FairCom's c-tree Plus within vertical market 
products and licensed its Server teclmology for OEM uses 
http://www.faircom.com 

QuickCRC 1.1 

Object-Orienteo Software Design Tool 

Excel Software is shipping QutckCRC 1.1 for Macintosh and 
Windows 95/NT. QuickCRC is a design tool for discovering 
objects and related information for an object-oriented software 
development project. It automates the CRC card concept of 
identifying classes, respr^nsibilities and coUatorations between 
objects. Design .scenarios involving a group of communicating 
objecLs can t)u identified and simulated. New features in thb 
release include a contents view, inheritance graph and hill text 
tmpon and export of design information. 

QuickCRC uses a diagram workspace for creating card and 
scenario objects. A card represents the properties of a class 
including its name, description, superclasses, subclasses, 
attributes, respoasibiiities and collaborating objects. A scenario 
represents a design mechanism defined as a series of steps 
involving communicating objects. Scenarios can reference cards 
or other scenarios. Cards and scenarios can also reference 
external agents defined by the designer to identify sysiem and 
user interfaces. As information t.s entered or changed for a card or 
scenario object, Ir is instantly syndironized ihjoughout the mtxlel 


Separate diagrams partition a model into subject areas, Ihe 
contents view allows 3 designer to navigate Ijctween diagrams 
shown as folder icons that can be opened or closed. From the 
contents view, a card or scenario can be dragged between 
diagrams or double-clicked to edit its properties. This makes it 
easy to locate and modify information as the model grow.s. 

llie inheritance graph concisely illustrates the class 
inheritance structure of the model. It gets generated from 
information on the CRC cards regardless of how die cards are 
physically arranged or partitioned between diagrams. Several 
inheritance graphs can be active for different root classes in the 
CRC model to focus attention on different parts of a large design. 
The properties of a card can viewed or edited by double¬ 
clicking its name on the inlieritance graph. 

The List Diagrams command generates a text representation 
of the information in a CRC model in a syntaaically simple 
format, lliis information can be transferred to other applications 
or used to generate a new CRC model with the Import Diagrams 
command. Design models can be exported or imported to Excel 
Software’s MacA^tD and WinA&D software engineering tc.H>ls for 
detailed design or eexie generation. Likewise, Excel Software’s 
reengineering tools can be used to generate QuickCRC design 
models from existing code. 
http;//www.excelsoftw3rexom 

AAA+ Software Ships Joy Release 1.08 for OPENSTEP, 
Rhapsody and Wevdows 

AAA+ Software announces release 1.08 of Joy Explorer and 
Joy Developer, the company's developer pnxluctivity and rapid 
application development tcx>ls. Joy applications run on Wmdow.s 
95/NT, Apple Rhapsody, and OPENSTEP/MachOS, No porting or 
compiling i.s rec|uired. 

Release L08 offers enhancemems including: 

• Joy graphical application inspector integrated into Joy 
command window. 

■ Joy Developer’s "Save Nib a,H App” now creates stand-alone 
applications for use on any deployment platform. 

■ Unking Joy into non-Joy applications made easier 

Joy Explorer is the ideal tool for exploring the Yellow Box 
frameworks. Developers can create small utilities by using just 
Rhapstxly’s Joy-enhanced Interface Builder application. No other 
development tools are required. These utilities will run in 
Interface Butlderis Test Interface mode. 

Joy Developer provides full functionality for developing 
sophisticated applications. There is no need to re-compile, re¬ 
link and re-establish test scenarios to explore new ideas. Using 
the "Save Nib as App" feature, users can turn graphical user 
interfaces created in Interface Builder into standalone 
applications that run on any OPEN5TEP or Yellow Box platform. 
hnp://wvM.aaa-plus,com/joy/ 
http://v>ww.aaa-plus.com/joy/download.^ 
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guarantee would be cool 

Then, someone suggested a 

30-day satisfaction guarantee 
...and we thought we’d do that 

too. Then, someone else called 

every vendor they could think of, 
and stocked hundreds of tools, 


books, accessories and eveiythin 

else a developer/programmer w^ould 

em want, Then, we set up toll-free 
phones, an awesome Web sire, fax 
lines, and e-mail aecounts so oiiir 
taistomers could order; 
as possible. Pmally, some dude 
goes: “hey, let’s ju.st give 
away prtKhicts f(ir FRFii!" 

Yeah 



E-mail; orders@devdepot.com • Web site: http://www.devdepot.com 
Phone: 800-MACDEV-1 - 805-494-9797 (outside the U.S. & Canada) • Fax: 805-494-9798 






THE 

CLASSIFIEDS 



The Law Office of Bradley M. Sniderman 

California Lawyer focuaing on Intellectual Property^ Corporatep 
Commercial and Contract law^ as well as Wills and Trusts. 

If you are looking to protect your software with Copyright or 
Trademark protection, or if you need help establishing or 
maintaining your business, please give me a call or an e-mail. 
Reasonable fees. 

(310) 553-4054 
Brad@Sniderman.com 


_ Macintosh Programmer 

Macintosh projgrammer needed for challenging 
position to assist in development of cross-platform 
experiment-authoring package for psychologist. 
Software allows users to author and run real-time 
cognitive experiments using scripting laniguage or 
graphic interface. Help us to create a first-class 
Macintosh product. New positions immediately 
available at small Pittsburgh area software firm. 
Send cover letter, resume and salary requirements to 
Human Resources, Psychology Software Tools, 2014 
Monongahela Avenue, Pittsburgh, PA 15218 or e- 
mail to info@pstnet.com. See www.pstnet.com for 
more information. 



ProfessHHial Software Developers 

Looking for career opportunities? 
Check out our website! 

Nationwid^ervice 
Employment Assistance 
Resume Help 
Marketabil ity Assessment 
Never a fee 

Scientific Placement, Inc. 

8()()-231 -5920 800-757-9003 (Fax) 

das @ sc ientific.com 

___ J 



move? 


r Depot! 


The fastest, cost effective way to get product off your shelves. 

For information: • Voice: 805/494-9797 • Fax: 805/494-9798 • E-mail: vendor_re!afions@devdepot.com 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech® Magazine and 
Apple’s develop” issues 1-29! 


.. .in THINK Reference"" 


So hurry, pick up the phone, Are up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech* CD-ROM. 


Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 

Includes Apple develop issues 1-29 

Improved hypertext, improved indices, and a new THINK 
Reference Viewer — for lightning quick access! 

New hyperlinks between articles 

100-1- MB of source code — use them in your applications, with no royalties! 

Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. 1-VI 

80MB of FrameWorks/vSFA archives and the most complete set of FrameWorks 
archives known 



Sprocket! MacTech’s tiny fnunework that compiles quickly and supports 
System 7.5 features 

The best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 


Popular tools that Mac programmers use to increase their productivity and 
much more! 



Web Site: http//www.devdepot.corn • E-mail: orders@devdepot.com 

Phone: 800-MACDEV-l • Outside die U.S. & Canada: 805-494-9797 • Fax: 805494-9798 


MacTech ts a registarad tractemark of Xpiain Corporation. MacOev-1, THINK Reteronce, Developer Depot, Sprocket. JaveTech, WebTech, BeTech, and the MacTutorMar 
are trademarks of Xptain Corporation. Other trademarks and copyrights appearing in this printing or software remain the property of their respective holders. 
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CodeWarrior for 
PaImPilot 


Release 4 

by Metrowerks 

CodeWarrior for PaImPilol 
is the first compiete set of 
toois which enables you to 
deveiop for the U.S. 

Robotics PaImPiiot 
connected organizer, from 
the comfort of your PC or Macintosh computer. Ail the toois you 
need are inciuded: the award-winning CodeWarrior IDE, 
compiier, iinker. source-ievel debugger. GUI builder, and other 
toots, ptus ontine documentation and reference materiats. 
tnctudes one free product update and tree technicat support 
with registration. 

(SCWPALM) Our Price $369 


metrowerks 


Check out our Web site! 


• Full product descriptions • Hundreds of more products 

http://tivww.devdepot.com 



CodeWarrior 
Latitude 

by Metrowerks 

Don’t throw away the 
investment you have made 
in your Mac OS appttcation! 

With the new DR2 reiease 
of CodeWarrior Latitude, you 
can now port your Mac OS 
appiication to Rhapsody, as 
weli as Siiicon Graphics iRiX 
and Sun Soiaris. At the 

heart of Latitude is a set of shared iibraries which performs the 
functions of the Macintosh APi. You recompiie your Mac OS source 
code, linking it with the Latitude libraries to produce a native 
application. As the Rhapsody API evolves, so will Latitude. 
Registered users of CodeWarrior Latitude will receive aii developer 
releases, the first full release, plus one additional product update, 
to ensure that you have access to the most up-to-date Rhapsody 
porting tools available. 

(SCWLAl) Our Price $399 


Be 

OS 


CodeWarrior 
for BeOS 3 

by Metrowerks 



• Start programming for the new. innovative Be Operating 
System (BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar Codewarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C-H- classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program for 
the BeOS on a 603 or 604 PCI based PowerMac 

(SCWFB) Our Price $299 



MW Visual 
SourceSafe 
Release 5 

by Metrowerks 

• Source code control 
system, plug-in to the 
Codewarrior IDE or 
stand-alone Client 
application 

• Compatible with Microsoft Visual SourceSafe version 5.0 

• Cross-platform support (Mac, Windows, UNIX) 

• Configuration management in excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support 
and one free update 

(SMWVSS) Our Price $499 
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full-featured 


CodeWarrior 
Discover 
Programming 

Dy Metrowerks 

• Learn to program in 
C/C-H+/Java/Pascal 

• Full-featured programming product-not a "lite" edition 

• Online books and tutorials 

• Hosted on either Mac OS or Windows 95/NT 
CodeWarrior Discover Programming Edition offers an unbeatable 

programming tools, online books 
diiu II ibii uuuui idi (iidiBiidii), all at a great price. Whether you 
want to learn the basics of programming or add a new language ; 
to your skiii set, Discover Programming puts the information ^d 
tools you need at your fingertips; the award-winnihg, easy-to- [ 
use CodeWarrior Integrated Development Environment (IDE), ' 
four of the most popular programming languages, online books, 
online tutorials, sample source code and free technical support , 
(with your registration). Discover what you can learn with 
CodeWarrior, buy your copy today! 

(SDPED) Our Price $79 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90, VAX compatible F77, and 
C/C-t-i- compilers into a single, easy to use environment. Ail compilers 
are link compatible and operate through a common interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Maks, several utilities, fine 
latest version of MPW and illustrated documentation 

• Whole atray operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C-f-i-, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 



CodeWarrior 
Professional Release 2 

by Metrowerks 


•Includes Windows 95/NT and Mac 
OS versions of the CodeWarrior IDE 

• Supports C, C-t-h, Java and Pascal 

• Develop for Windows 95/NT on x86 and Mac OS on 68K/PowerPC 

• V2 Project Manager supports multiple open projects, subprojects, 
multiple targets per project, and threaded execution 

• Support tor JDK 1.1.3 in CodeWarrior Java 

More platforms, more languages, more options; CodeWarrior 
Professional Is designed to give you the tools you need for serious, 
industrial-strength programming. CodeWarrior Professional is the 
only Integrated Development Environment (IDE) in which you cah 
edit, compile and debug C, C-i-i-, Java and Pascal programs for 
multiple target processors and operating systems. CodeWarrior's 
compilers produce fast, highly optimized code for Windows 95/NT 
running on x86, or Mac OS running on 68K or PowerPC prxessors. 
CodeWarrior Professional features the CodeWarrior IDE Version 2. 
The revamped Project Manager supports multiple projects open 
simultaneously, multiple targets per project, and threaded execufion, 
and it's significantly faster. CodeWarrior Professional also includes 
online books, dxumentation, and reference materials, as well as 
tutorials and sample code. We support 
your development efforts with one free update and free world- 
class technical support for a year with registration. 

(SCWPRC2) Our Price $449 


BeOS Preview 
Release 2 

by Be, Inc. 

As the Internet spreads and 
electronic media becomes more 
prevalent, the high-pertormance 
needs of digital content design and 
the complex, aging architectures of 
current mainstream operating 
systems are coming info conflict. The BeOS is the first operating 
system designed to unlock the door to much more powerful 
personal computers, and extract more performance from the 
systems we use today. 

(SBEOS) Our Price $49 




Maciiitosh Common Lisp 4.0 

by Digitool, Inc. 

Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, 
and academic research. 


• Power PC native environment & compiler, full Macintosh support 

• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 110-t- mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCLISP) Our Price $675 



Web site; http;//www.devdepot.com • E-mail: orders@devdepot.com 
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Visual Cafe for Java 
Professional 
Development Edition 

by Symantec 

• Powerful Java and JavaBeans IDE 
with Plug-and-Play JavaBeans 
functionality 

• lOO-r Professional. Reusable 


JavaBeans Component with Source Code 

Full JDK 1.1 Support via MRJ 2.0 

Latest Java Foundation Class (JFC) Library 

Comprehensive source editor with color coding and keyword 

highlighting 

On-the-fly Class reusability 

Turn Auto Code Generation On/Off Environment (RRAO On/Off) 
Powerful debugging Tools including debugging in any 
application running MRJ 2.0 and breakpoint view 
Netscape communicator 4.0 
Full featured Visual Page KTML Authoring Tool 
(SVCJAVA) Our Price $299 
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visual Cafe for Java 
Database 

Development Edition 

by Symantec 

FileMaker Pro and BlueWorld Lasso 
trialware versions 

.. . 100-r Database aware JavaBeans 

Sybase SQL 

• Anywhere server-side database with development and runtime 
engines for Win95/NT 

• DbANYWHERE server-side server 100% JDBC middleware 
with native drivers for Informix, Sybase, Oracle and Microsoft 
SQL server 

• Support for over SO-i- databases through ODBC 

• Swift and scal^le data access with dbANYWHERE's true three 
tier architecture 

• Netscape Fast Track Web Server (Win 95} 

• Netscape Communicator 4.0 
(SVCJDB) Our Price $499 






ML-f ' " 'V Microkernel Linux 

MKLmuX for the Power Macintosh 

by Prime Time Freeware 

MkLinux is a native port of Mach 3 and the 
Linux 2.0 kernel, complemented by 
hundreds of commands from BSD, GNU. and 
X11. It runs on most (NuBus and PCI bus) 
Power Macintosh systems; Perlorma, 
PowerBook, and multiprocessor ports are currently under 
development. 

MkLinux is robust, powerful, freely distribiiiabie, and source code 
compatible with most other Linux systems. It provides a lull suite of 
development tools, support for AppleTalk, NFS, and Objective-C, and 
access to a vast amount of tree software. MkLinux is a great way to 
“come up to speed” on Mach. UNIX, and Rliapsody. 

• MkLinux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Linux, Mach, NeXT, and the 
Power Macintosh 

• Includes free 3.0 upgrade 
(BMKLINUX) Our Price $49 


Order Toll-free 
800-MACnV-1 


P622-338II 


VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 

Macintosh and Power Macintosh applications in standard BASIC code! 

VIP-BASIC 2.0 is hie fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compHafion with Metrowerks' CodeWarrior 
(SVIPBASIC) 0urPrlce$195 



VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger. Impart pre¬ 
existing C code: automatically integrate C code with a current project 

• Includes full-featured mini database: (ltd to 32K) of the powerful 
VIP-BASIC datable manager gives you everything you need to 
setup royalty-free, multi-user database applications 

(SVIPC) Our Price $295 
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CodeBuilder 

by Tenon Intersystems 

CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C. 
C++, Objective-C, Java. Ada. and Fortran development tools 

• Complete UNIX & X development environment for developing 
UNIX or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, 
and C. C++, Ada 95 and Fortran 77 

• Web & interrtet scripting tools: Ped, MacPerl, tcl/tk, bash, sh. 
andcsh 

■ Supports Rhapsody kernel APIs and Rhapsody TCP sxkets 
(SMIOCODEB) OurPrice$149 


SmalltalkAgents for Macintosh 

by Quasar Knowledge Systems, Inc. 

• An Integrated Development Environment (IDE) based on QKS 
Smalltalk. 

• “Live" direct manipulation of your objects 

• Dynamic, interactive and iterative development process 

• Easy and full access to the features of the Mac 0S(tm) and Mac 
Toolbox 

• Link your non-Smalltalk code fragment w'rth Code Fragment 
Manager (CFM) support 

• Cross-reterence. access, view, and manipulate your code and 
objects with a sophisticated database tor source code 
management 

• Includes an Application Delivery Toolldt(tm) (ADT) that allows you 
to create royalty-free, standalone, double-clickable applications 
(SSTA) Our Price $395 


Check out our Web site! 

i ' • Full product descriptions • Hundreds of more products 

^ http://www.devdepot.com 


NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

• Create files, access the built in soups, and the serial port for 
input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from www.nsbasic.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Also runs on MP 1201s with NOS 2.0 that 
have full memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 



ObJectMaster 
Professional Edition 

by Altura Software, Inc. 

Object Master is an innovative programming environment that 
provides all the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate ail files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 
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WAIT 

there* Here’s a list of all available products. For full product descriptions 
lore! J please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSEORT 

595.00 

LS Fortran Plug-In 

SLSFPI 

199.00 

Mac FORTBAN !l 

SF0RT2 

595.00 

Power MachTen-UNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

Think Pascal 4.0 

SPASCAL 

165.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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PowerKey Pro Model 200 

by Sophisticated Circuits 
PowerKey Pro Modei 200 iets you start 
up and shut down your Mac and up to 
five peripherais with a . _ 


singie keystroke. Two 
groups of switched 
outiets let you controi 
some peripherais 
separately. PowerKey 
aiso features phone 
ring startup which 
iets you access your 
Mac whiie on 
the road. 

Powerfui scheduiing 
features let you 
controi your outlets with “hot keys" or 
perform tasks unattended. Start up your 
computer at any time of the day or night 
open applications and run AppieScripts 
or QuicKeys. Add the optionai Server 
Restart Option and you can even restart 
crashed servers automaticaiiy! 

System Requirements: Mac with ADB 
port, System 7 or iater, Telephone 
features require analog phone line. 
(HPKEY2) Our Price $99 



PowerKey Pro Model 600 

by Sophisticated Circuits 

PowerKey Pro Model 600 is "the world’s 
smartest power stripl" Start up and shut down 
your Mac and 
peripherals with a single 
keystroke. Includes stx 
individually-switched 
outlets, with manual 
switches and indicator 
lights. Powerful 
scheduling features let 
you control outlets with 
“hot keys" or perform 
tasks unattended. Start 
up your computer at any 
time of the day or night, 
c^n applications and run AppleScripts or 
QuicKeys. Complete telephone controllability 
lets you start up the computer, switch outlets 
or mn complex events using custom touch- 
tone commands. For a limited time, Model 600 
includes the Server Restart Option. Restart 
crashed servers automatically! 

System Requirements: Mac with ADB port, 
System 7 or later. Telephone features require 
analog phone line. 

(HPKEY6) Our Price $199 
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SpotCheck 

by GenieWorks, LLC 

^otCheck is a language-based editor that 
“knows" the Java language. It Is designed to 
help a Java programmer produce correct 
code without relying on confusing and 
untimely feedback from a compiler. 

Specifically, SpotCheck identifies syntax 
errors and Semitic errors [undefined 
names, type mismatches, etc.) those errors 
normally returned by a compiler. This 
analysis is performed after each edit, giving 
the programmer immediate feedback on 
errors. SpotCheck provides a host of 
additional features, including: 

• smart links to name declarations 

• cross-referenced Java APIs 

• editing with popup menus 

• interfaces to helper apps to compile & run 

• hierarchical project browsing 

• color-coded syntax 
(SCHK) Our Price $59 
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Joy Explorer 

by AAA-^ Software 


Joy Explorer gets you started with 

Rhapsody programming quickly: 

• Step by step tutorial for implementing 
simple applications 

• Graphical application inspector for 
inspecting classes, instances, methods, 
and data structures inside any 
Rhapsody application. 

• Interactive sending of messages to 
objects 

• Extension to Rhapsody’s Interface 
Builder which permits 
Implementation of prototypes right 
within Interface Builder - no need to use 
any tools except Interface Builder; no 
need to compile and link. 

• Example programs with full source code, 
including source code for application 
inspector. 

(SJOYEX) Our Price $69 


Joy Developer 

by AM+ Software 

Joy Developer is an essential tool for anyone serious about developing for Rhstosody; 

• Rapid application development right within Rhapsody’s Interface Builder 

• Incremental extension of existing applications (test-fix-go) without any need to recompile, 
relink or restart the application 

• Turn interface files into standalone applications that run on any Yellow Box platform simply 
by using the new “Save Nib As App” command in Interface Builder 

• Mix-and-match interpreted scripts and compiled code freely; anything you can do in 
compiled Objective-C and Java can be done in Joy - and more, 

• Full support for all Objective-C classes, typedefs, macros, data structures, exceptions, 
Tcl 8,0 commands and extensions, including byte-code compiler to boost performance 
(SJOYDEV) Our Price $399 


NetMinder Ethernet 

by Neon Software 

NetMinder Ethernet is a software-only protocol analyzer which 
captures and decodes a full range of Ethernet protocols including IP, 
AppleTalk, NetWare, NetBIOS and DECnet. Features include: 

• Sophisticated long-term monitoring with HTML output 

• Intuitive and powerful filtering capabilities 

• Automatic mapping of names to Ethernet, AppleTalk, and IP Addresses 

• Rules-based engine for detecting unusual network conditions 

• Customizable graphs for bandwidto utilization and packet rates 
(SNETMD) Our Price $715 
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Visual MacStandardBasic 3.0 

by ZCurve Software 



Visual MacStandardBasic is the new standard for creating both 

68K and Power Macintosh applications. 

• Applications can be visually created in minutes 

• Visual controls such as command buttons, text boxes, list 
boxes, radio buttons, check boxes, scrollbars, icons, pictures 
and timers can be created and modified instantly 

• Use color graphics, animations, movies, sounds and speech 
in your programs 

• Console text window option helps converting older BASIC 
source code from other platforms 

• Online tutorial, manuals, sample pipjects get you programming quickly 

(SVMACSB) Our Price $29.95 
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Spotlight 

by Onyx Technology, Inc. 

Spotlight is a stand alone 
debugging aid that performs memory 
protection (arrays, heap accesses, outside 
your heap, low mem, etc), discipline checking 
on toolbox calls, and leaks detection, 

• Spotlight is sold on an annual subscription 
basis 

• The subscription service provides all updates 

• Includes maintenance releases for one 
year after 

the initial purchase or renewal date. 
(SSPTLT) Our Price $199 


QC 

by Onyx Technology, Inc. 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scrambles, 
handle/pointer validation, dispose/release checks, write to 
zero, de-reterence zero as well as other tests like free 
memory invalidation and block bounds checking 

• Extremely user friendly - ideal tor non-programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 



Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and templates lor building your own 
Web Page. An Incredible selection of Shockwave movies, animated GIFs, 
butlomi, bullets, dividers, and sample HTML pages. There are literally 
thousands of graphical element on this disc, all there to spice up your 
web page. In all. it's about 300 megabytes of creativity only a mouse-click away! System 
Requirements: PC - 486 or better with 8 MB FIAM, Sound card, SuperVGA. CD-ROM drive. 
Macintosh - Color Mac with 8 MB RAM. CD-ROM drive. 

(SWEBW) 0urPrice$24 




Apprentice 7 

by Cetestin Company 

Apprentice 7 is a high-quality CD-ROM 
collection of over 600 megabytes of up-to- 
date source code, utilies, and info for Mac 
programmers. All of the source code and 
utilities are completely new or updated tor 
this release. 

• Frontier 4.1. the highly-acclaimed 
scripting environment 

• More PowerPlant AND many more 
PowerPC samples 

• Cool new languages and environments 
added (Clean, Eiffel, F.Tci-Tk) 

• Hot new demos from leading Mac 
development companies 
(SAPPRENT) Our Price $35 


StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional 
replacement for the List 
Manager used by developers worldwide. 
Version 3.0 is a new release with many 
improvements including better clipboard and 
drag/drop integration with other applications. 
> Available for use with CodeWarrior C & 
Pascal 

• Includes libraries lor 68K (A4 & A5) and 
PowerPC 

• An LTable-like class Is provided to 
incorporate StoneTable into the 
PowerPlant environment 
(SSTONEFAT) Our Price $199 



VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version control tool for all 
sorts of projects (software 
development, documentation, design, 
CAD, publishing, etc.) 

• Smooth integration with Metrowerks 
CodeWarrior and BBEdit. 

• Simple and clear management ot variants 
and revisions of entire projects (not only 
of single files) 

• Easy-to-use graphical project browiser gives 
access to all versions that were ever stored. 


• Recording of the complete history (who 
made which changes when and why) 

• View differences between versions (not 
only for text files!) 

• Efficient delta storage ot arbitrary files 
(text as well as non text 

files) gains savings of 95 % and more 

■ Administration of users with hierarchical 
access rights 

■ Configurable local file locking (Finder flag 
or 'ckid' resource) 

• Scriptable, essential parts PowerPC native 

Single license (SV00D001) $229 

2pack(SV00D002) $359 

5pack(SV00D005) $799 

lOpack(SVOODOOIO) $1369 

20 pack (SV00D0020) $2399 

Additional pricing available on request. 

SEE RELATED CATEGORY; Dev. Environments 
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ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for 
integrating Internet e-mail in your 
applications 

• Helps you write software that can 
share mail with other leading 
e-mail products 

• Royalty-free MIME. SMTP, and 
POP3 APIs for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free stemdard technical support 
(SOSMSDK) 0urPrice$495 



CodeBuilder "TENON 

by Tenon Intersystems intebsvsiems 

CodeBuilder is a powerful and unique Macintosh software 

development tool for porting existing apps or developing new. 

advanced applicalions on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C++, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C++, Ada 95 and Fortran 77 

• Web & internet scripting toois; Pert, MacPerl, tcl/tk, bash, sh, 
andcsh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 


Guide Composer™ 1.2 

by StepUp Software 

• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG development environment: Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same formal as the user 
will use them 

• Features are WYSIWYG interface, Topics, phrases, and 
hierarchical phrases. Coach marks, Fully-Integrated with Apple's 
Guide Maker (distributed with Guide Composer), compiles scripts 
automatically, PICTs in Panels, (venerated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http;//www.guideworks.com/ 

(SGCOMP) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman’s 

AppleGuide Starter Kit. Real World AppleGuide 
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B-U'ee HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine 
for Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts files when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less than, or greater than a given value 
in a few hundredtes of a second 

• Finds lists of records whose keys are equal to. less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 




BBEdit4.5 

by Bare Bones Software 

BBEdit 4.5 is a powerful, easy-to- 
learn text and HTML editor that 
I developers and HTML 

aB^^4.51 authors the ability to build on its 
core functionality to suite their 
specific needs through Its plug-in architecture and scripting 
capabiiites. This new version includes: a visual table tool that 
speeds page and site development, contextual menu support for 
Mac OS 8, improved storage for 'grep' patterns, scriptable HTML 
authoring preferences and more. It still provides; unparalleled 
searching muscle with support for both ‘grep’ style and advanced 
literal searches, the ability to quickly compare differences 
between files or entire folders, integrated support for Symantec's 
IDE, Metrowerks CodeWarrior, THINK Reference 2.x, MPW 
Toolserver and most other environments and a heck of a lot more. 
(S8BEDIT) Our Price $119 
Also see Internet Related, page 12 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer “atoms" lhal let developers incorporate 
graphics, sounds, file compression and custom folder icons Into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 

(SINSTALL) OurPrtce $219 ^ 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp's InstalterPack, Stuftit decompression. Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 
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BeSpecific 3 

(Thlml in a series) 

by Adamation 

The best-selling BeSpecific CDROM series 
provides the best in BeOS 
shareware across a wide range of 
application areas, including: 

• Productivity programs • Latest source code 

• Programming toots • Graphics Gamre 

• Commercial demos 

Newsgroup archives (comp.sys.be) Developer mailing list (Be DevTalK) 
BeSpecific 3 is brimming with useful BeOS Preview Release- 
compatible software. A "must have" companion for all users of the 
BeOS. 

(SBESPEQ Our Price $39 


Pilot Attache Disk 1 

(First in a reguiar series) 

by Adamation 

The Pilot Attach^ CDROM, designed for the 
popular US Robotics Palm Pilot organizer 
provides you the best in Pilot shareware. 

Extend your Pilot's capabilities across a 
wide range of application areas, including; 

• Personal productivity tools • Newsgroup information 

• Programming tools • Games 

• Utilities 

Fully tested, Pilot Attache's shareware treasure throve will help you 
get the most out of your Palm Pilot. When you travel with your Pilot, 
don't forget your Attache. Pilot Attache...yaur passport to success. 
(SPATCHE) Our Price $29 




Water's Edge Software 


Tools Plus libraries + 
framework 

by Water’s Edge Software 

Easily create compact, fast running, 
professional looking applications and plug-ins*. 
Tools Plus lets you create virtually any user 
interface element with a Single routine, and it 
transparently provides a robust infrastructure to 
make all your pieces work together as an 
application. 

• Simplifies programming and thins source 
code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes 
and tool bars to powerful picture buttons 

• Includes numerous 3D grayscale ophons 


• Over 1/2 MB Of custom fonts, icons, 
cursors, and other resources 

• Includes SuperCDEFs world-class controls 
(an $89 value) free 

(STOOLCW) Our Price $249 

CodeWarrior Gold 

{C/C++ & Pascal, 68K & PPC) 

(STOOLCWB) Our Price $199 
CkrdeWarrior Bronze (C/C-i-i- & Pascal. 68K) 

(STOOLSYMT) Our Price $199 
Symantec (THINK) C/C-i-i- and THINK 
Pascal (68K) 

(STOOLSYM) Our Price $149 
Symantec (THINK) C/C-e-t- (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

•CodeWarrior required to write plug-ins 


AppMaker 

by Bowers Development 

• Develop hie user interface for a Macintosh application 
using the original interface builder 

• Just point and click to design your application 

• Creates resources and generates excellent source code 

• Supports most development environments including 
Metrowerks, Symantec, or MPW; C, C-h-i-. or Pascal: 
procedural or object-oriented, using PowerPlant, TCL, 
or MacApp 

• The generated code uses the Universal Headers to provide PowerMac compatibility 

• Great tool tor beginners to learn object-oriented and Macintosh Toolbox programming 
techniques 

• Includes one-year subscription on CD and hardcopy documentation 
(SAPPMAKE) Our Price $199 













Tesllh'ack-Bug Ikracking 
the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test 
configurations, users, and more 

• Includes notifications, security, a 
powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, 
documentations staff, and project 
managers together to ensure all bugs 
are Identified, fixed, and documented 

• Eliminates the need to build custom 
bug tracking solutions using general 
purpose database tools 

• Supports single- and multi-user bug 
databases (additional licenses 
required to use multi-user features) 
(STETR) 0urPrice$169 
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Check out our Web site! 

■ Full product descriptions • Hundreds of more products 

http://www.devdepot.coiii 



Memory Mine 

by Adianta, Inc. 


• Monitor heaps, identity problems such as memory leaks, and 
stress test applications 

• Active status of memory in a heap is sampled on the fly; 
allocation In non-relocatable (Ptr^, relocatable (Handle) and free 
space is shown, as are heap corruption, fragmenMion, and more 

• Allocate. Purge, Compact, and Zap memory lets users stress test 
all or part of a program 

(SMEMMINE) 0urPrice$99 
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SuperAnaiyst 

by SuperSoft 

SuperAnaiyst is an easy- 
to-use data analysis and 
plotting application 
written specifically for 
the Apple Macintosh 
computer and PowerPC. 

It provides a wide range 
of X-Y plotting and analysis capabilities at a cilck of the mouse. It 
is easy to use and provides interactive control of the appearance of 
almost every characteristic of your plot. You can overlay multiple 
plots on the same graph, and the number of points is limited only 
by the memory of you computer. 

(SSANAL) Our Price $99 



Future BASIC II 

by Staz Software 

FutureBASIC II is the award 
winning leader in Macintosh BASIC 
programming. 

• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example tiles 

• Full support of standard BASIC 
{SFBASIC2) Our Price $229 


AG Author 

by Lakewood Software 

AG Author 1.0 is a full-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author; 

• Support for styled, colored, & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Rapid deployment of project globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS; AppleGuide Complete, Danny Goodman's 
AppleGuide Starter Kit. Real World AppleGukte 


SoftPolish CD-ROM 

I by Bare Bones Software 

I • The essential tool for software quaiily 
^^^"**"* assurance on the Macintosh 
Helps you identify inconsistencies with Apple’s user interface guidelines, 
misspelled words, missing resources, and other mistakes 
Prowdes tools to put the finishing touches on software distribution 
packages prior to release 

Works independently of any programming language or environment 
Ideal for sanity checking software throughout the development process 
(SSOFTPOL) Our price $99 


SuperflotPRO 

by SuperSoft 

• Plotting data from your program was never easier 

• A Plotflng and Chart Library callable from Fortran, Pascal, and C 

• Plot Types: Scatter, log-log, x semi-tog, y semi-log, Ddouble Y, 
cross, line, line w/ symbols, bar, stacked bar, column, stacked 
column, area, pie, polar 

(SSPLOTPRO) Our Price $295 


Feel ^ 
about \ 
purchcfiei 


idHjl * 

jfWm 

ch^n X 


10 1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805494-9798 


































































Be Basics 

by BeatWare 

Be Basics is the first productivity suite to 
combine the essential tools you use 
everyday with the incredible power of the 
BeOS. Be Basics 

offers the BeOS developer the ability to; 

• Combine text, tables, graphs and pictures to create compelling 
documents 



OpenGL for 
the Macintosh 

by Conix Graphics 


^pen GL 


OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhance the development of all graphics software; 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color index mode 


• Work with multiple files simultaneously without degrading performance 

• View all layout, style and content changes as they happen 

• Import Microsoft Excel files 

• Plug-in third party graphs and filters 

Be Basics requires the BeOS, 16 MB of RAM, 2 MB available hard 
disk space and a 256-color display adapter. 

Price includes all major and minor upgrades through version 2.0 via 
electronic distribution. 

(SBEBASIC) Our Price $69 


Viewing and modeling transformations 

Texhjre Mapping, Lighting, Shading and 1 Buffering 

Atmospheric Effects (fog, smoke, and haze) 

Alpha Blending (transparency) 

Antialiasing. Accumulation Buffer. Stencil Planes 
Display list or immediate mode 

Polynomial Evaluators (to support Non-uniform rational B-splines) 
Feedback. Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

Pixel Operations (storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 
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Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT 

Bee-one 

C-tree Plus® Database Handler 
Comp He It! 


CPU Doubler 
DesignWorks 4.0 
dtp 

EtherPeek 
Fortran 77 SDK 
ICONIXPowerTools-6Pack 
ICONIXPowerTools-8Pack 
ICONIX PovrerTools-IO Pack 
ICONIX PowerTools-AdaFlow 
ICONIX PoviferToois-ASCII Bridge 
ICONIX PovrerToots-CoCoPro 
ICONIX PowerTools-DataModeter 
ICONIX Povi«rTools-FastTad< 

ICONIX PowerTools-FreeRow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTods-PowerPDL 
ICONIX PowerToots-QuickChart 
ICONIX PowerTools-SmartChart 
ICONIX Training & Consulting 
IMSL Math and Stat Library 
Info-Mac X 

Ionizer Real-Time ^jeclral Reshaping Tool 
LiveAccess™ 1 User Edition 
LiveAccess^” 1 Developer Edition 
UveCard 
U Profiler 
MacA&D 6.0 

MacFlow": Rowchart Design and Devel(X)ment 
Mac Source II 
Nisus Wnter 5.0 

Plan & Track''*': Project Planning and Management 

Phyla™': Object-Oriented Database 

QUED/M 3.0 

r-tree Report Generator 

Spellswell Plus 2.1 

SuperPlot 

Visual Caf6 

VText 


CODE 

OUR PRICE 

SBEEONE 

$139.00 

SCTPDH 

$895.00 

SCOMPIT 

$149.00 

SCPU2X 

$79.00 

SDWORKS 

$995.00 

SOTF 

$695.00 

SEPEEK 

$745.00 

SF77 

$699.00 

SICPP6 

$5,945.00 

SICPP8 

$6,945.00 

SICPP10 

$7,845.00 

SICADA 

$1,395.00 

SICASCII 

$1,395.00 

SICCOCO 

$1,395.00 

SICDATAMOD 

$1,395.00 

SICFASTTASK 

$1,395.00 

SICFREEa 

$1,395.00 

SICOBJMOD 

$1,395.00 

SICPOWER 

$1,395.00 

SICQUICKCH 

$1,395.00 

SICSMART 

$1,395.00 

TICONiX 

$2,945.00 

SIMSLSTAT 

$495.00 

SINFOMAC10 

$39.00 

SIONIZER 

$800.00 

SLAUE 

$69.00 

SLADE 

$99.00 

SLCARO 

$149.00 

SUPROF 

$295.00 

SMACADP 

$1,995.00 

SMACFLO 

$179.00 

SMACSOURCE 

$29.95 

SNISUSW 

$220.00 

SPLM1RK 

$179.00 

SPHYLA 

$179.00 

SOUEDM 

$69.00 

SRTRG 

$445.00 

SSPELL 

$49.00 

SSPLOT 

$195.00 

SVCAFEMAC 

$199.00 

SVTEXT 

$349.00 
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Lasso 2.5 

By Blueworld 
Communications 


too 

* * * ^ 72 


hassQ^ 


Lasso 2.5 is the ultimate 
RIeMaker Pro Web development 
tool for creating online stores, 
discussion groups and other 
robust web applications that can 
handle hundreds of thousands of 
hits per day. Over 50 new tags including math, string and 
variable allow unparralleled data handling capability. Create 
embedded operations with the iniine command. Lasso Server 
edition supports multihoming and offers superior perfonmance. 

Order Lasso today the award-winning tool that which sets the 
standard for Mac OS dynamic Web database publishing. 
•Multi-threaded performance 

• Supports CDML and LDML 

• Enhanced securtly for electronic commerce 

Lasso 2.5 CGI/Plug-ln (SLASPG) $499 

Usso 2.5 Server (SLASSVR) $649 



BBEdit 4.5 

by Bare Bones Software 

(SBBEDIT) Our Price $119 

Also see Tools, Libraries and 
Utilities, [mge 8 


WebTen 

by Tenon 
Intersystems 

WebTen is an 
industrial-strength, 
high-performance 
Apache Web server for 
Power Macs. WebTen's 
Web-based browser 
interface enables local 
or remote administration via your favorite browser. Since Apple's NeXT 
acquistion, Tenon has extended their unique “UNIX virtual machine" 
technology to produce a set of “Rhapsody-Ready" internet 
applications. WebTen is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon’s multi-threaded, pre-emptive 
multitasking environment 

• Tenon’s unique technology supports the widely acclaimed Apache 
Web server as a double-clickable Macintosh application 
(SWEBTEN) Our Price $495 




duCT! 

CyberStudio 

by GoLive Systems 

GoLive CyberStudio Is the complete 
solution for HTML layout, design 
and Web site management. It gives 
Macintosh users unprecedented 
creative control and f exibllity when 
designing a Web site. GoLive 
CyberStudio lets graphic designers and publishers visually 
design and manage a professional-quality Web site—including 
the latest multimedia features—without performing any HTML 
programming. Yet, GoLive CyberStudio also includes HTML 
source-code and JavaScript tools, which help Web designers 
and programmers integrate interactivity into a site. Because 
GoLive CyberStudio is the first Web site design software to 
always work in a native HTML file format, it allows graphic 
designers and Web programmers to work well together. 
(SCYBERS) Our Price $349 


ObjectSet Mail SBK 

by Smartcode Software 

• Powerful C-r-r classes for integrating 
Internet e-mail in your applications 

• Helps you write software hiat can share 
mail with other leading e-mail products 

• Royalty-free MIME, SMTP, and POP3 APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 
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HyperGuide 1.0 

by Lakewood Software 
HyperGuide 1.0 is a 
hybrid multimedia 
authoring tool and on¬ 
line documentation 
system for the 
Macintosh and World 
Wide Web. HyperGuide 
provides integrated 
searching, indexing and 
bookmarking features. 

Supported media elements include; rectangle and scrolling fields, 
lines and shape fills, most QuickTime-supported image formats, 
anti-aliased text and QuickTime VR movies. HyperGuide also 
includes an integrated screen capture utility and user-configurable 
slide show mode. 

(SHYPGUD) 0urPrice$149 
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PageCharmer; Sizzling Effects... 



PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code, 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES: 

LiveG-Map, LiveT-Map, LiveG-Button, LiveT-Button, UveGT-Button, 
LiveG-Ticker, UveT-Ticker, LiveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) Our Price $99 


Rumpus 

by Maxum Development 

Maxum's new, high- 
performance FTP server for 
the MacOS. Based on 
Maxum's RushHourTCP/!P implementation, Rumpus 1.0.1 offers 
the performance and reliability of high-end workstations with the 
ease of use, security, and flexibility of the Macintosh, 

• Simplified setup, with no need to configure /^pleShare, File 
Sharing, or Users & Groups for simple anonymous FTP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBinary and Binhex encoding 

• Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) 0urPrice$195 
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Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW, FTP, NFS, 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications In a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada, C, C-(-+, Pascal, Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Software.oom Inc's acclaimed Post.Office mail transport service 
(SM10PPC) Our Price $695 



CGi Toolkit 

by Plctorius, Inc. 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs and 
ACGIs tor your Mac Web site. 

• Interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

Interactively develop, test and debug CGIs before compiling 
Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 
Fully object oriented so you can re-use your code 
Automatic handling of Apple Events so you can concentrate on 
building functionality 

Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 
(SCGfTlKT) Our Price $149 


f WAi^*** 
t There's^ 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 


CODE OUR PRICE 


OOFILE Reporter Writer SOORW S499.00 

ScriptDemon SSDEMON S949.00 

WedAliasl.O SWEBALS SI 29.00 

WebSiphon SWSIPHON S495.00 
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TCP/IP 

Scripting Addition^ 

riir iMMUcn 


TCP/IP Scripting Addition 

by Mango Tree Software 

• Award-winning AppleScript scripting 
addition 

• Allows you to write scripts using 
MacTCP™ commands in AppleScript™ 

• Send e-mail or files through a script, 
check if users are logged on (via Finger), automate FTP, Gopher, 
NetNews, Telnet, and tPR. verify links in HTML documents, and 
quickly write many other TCP/IP client-senrer programs 
Works with AppleScript, MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 


Scripter 2.0 

by Main Event Software 
For professionals, for novices, for 
webmasters, for solutions providers, 
there’s only one serious choice. Scripter! 

• Scripter and FaceSpan work together; 
one click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call 
Box 

• Applet simulation, live editing, Object map, associated 
terminology 

• Search backwards, block generators, more navigation 
shortcuts, more drad-and-drop, and an even more enhanced 
trace log 

• Now Includes ScriplBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable 
application 

• Scripter is the natural companion to AppleScript for users at atl 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 



DynaMorph is the only cross-platform, server-side scripting language. 
Easily build and maintain dynamic websites and web-based 
applications. Access external databases, separate the format of a 
website from its content, conduct e-commerce transactions and 
more. DynaMorph makes sites and applications completely portabte. 
(SDYNA) Our Price $399 



FaceSpan v3.0 

by Digital Technology 
International 

FaceSpan is a cutting er^e interface 
design and rapid application 
development (RAD) tool which gives 
you the power to build and customize Macintosh applications quickly 
and easily. 

• Acts as your front end for AppleScript or any other OSA (Open 
Scripting Architecture) language. 

• Allows you to automate often-repeated tasks, customize and 
integrate existing applications, build new applications and 
personalize your computing environment. 

• NEW! Allows you to create interfaces and applications that 
conform to the Mac OS 8 look and feel. 

• NEW! Supported display objects now include tab panels, 
disclosure triangles, bevei buttons and more. 

• NEW! FaceSpan run-time now launches up to 5X faster. 

• includes an unlimited, royalty-free distribution license for the 
interfaces and applications you create. 

(SFACESPAN) Our Price $149 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects 
provided by scriptable applications 

• Includes Late Night Software Scripting Additions - a coliectlOT of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 



WindowScript 

by Royal Software, Inc. 

WindowrScript is the ultimate tool tor designing Macintosh user 
interfaces using HyperCard. Design Real “Macintosh" user- 
interfaces right inside HyperCard, Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript you 
can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you’re a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 


V/A®^*** 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

PreFab Player SPLAYER $95.00 
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CyberStudio 

by GoLive Systems 

GoLive CyberStudio is the complete 
solution for HTML layout, design 
and Web site management. It gives 
Macintosh users unprecedented 
creative control and flexibility when 
designing a Web site. GoLive 
CyberStudio lets graphic designers and publishers visually 
design and manage a professional-quality Web site—including 
the latest multimedia features—without performing any HTML 
programming. Yet, GoLive CybeStudio also includes HTML 
source-code and JavaScript tools, which help Web designers 
and programmers integrate interactivity into a site. Because 
GoLive CyberStudio is the first Web site design software to 
always work in a native HTML file format, it allows graphic 
designers and Web programmers to work well together 
(SCYBERS) Our Price $349 


ExposurePro 

by TTie Beale Street Group, Inc. 

ExposurePro allows you to, at the 
touch of a key (user-defined, of 
course}, freeze the screen, select a 
portion with the powerful selection 
tools, and save the image to a TIFF, 
GIF, PNG, JPEG, PICT, or PICT clipping 
file. You can also save to the 
Clipboard, Scrapbook, or even send it 
directly to your printer. 

The power of ExposurePro lies not only in its screen capture 
capablities, but also in the vast array of editing tools: painting 
tools, drawing tools, all with customizable features rivaling a full¬ 
blown image editing program. Convert to a different bit depth, 
Dither. The text tool might make you trash Illustrator! 

(SEPRO) Our Price $119 


• Photoshop Acquire Module that supports all devices including 
film cameras, (through scanners or photo CDs), digital cameras, 
video cameras and digital video cameras, 

• Small memory footprint 

• Clean user-friendly interface 

• Plug-in architecture 

• Export both QuickTime VR1.0 and 2.0 

System Requirements: Runs on Power PC only; requires 
allocation of 8 mb real RAM. 

(SNODE) 0urPrice$169 


Nodester 

by Roundabout Logic 

Nodester is Roundabout's 
renowned rapid panoramic 
editor for QuickTime VR. 
Nodester generates interactive QTVR panoramic movies which look 
out from a center or nodal point, allowing the viewer to experience 
the effect of a full 360 degree panorama. 

• Hot spot editor 

• Built- in image editor 


NewtCard 

by NS BASIC Corporation 

NewtCard lets you put text, 
drawings, pictures and sound 
into a stack of smart cards on 
your Newton. Add buttons to 
navigate, fields to collect data, 
and scripts to bring your project 
alive with the tap of a pen! 

• Create business solutions, 
education courseware, inter¬ 
active presentations and more 

in an easy to use environment. 

• Enter text, numbers dates and times easily. 

• Create your own drawings or copy drawings and text from 
NewtWorks 

• Navigate to other cards, stacks or applications by clicking 
buttons you create. 

• Add scripts to your stacks in easy to use BASIC! 

(SNEWT) Our Price $99 


Widgetizer 

By Roundabout Logic 

Widgetizer is Roundabout’s 

ii... I QuickTime VR. Widgetizer 

-1 generates interactive QTVR 

object movies which look in at a center point or plane, simulating 
the effect of holding an object in the hand and turning it around to 
see all sides, top and bottom. 

• Definable hot spots 

• Custom backgrounds 

• Frame-based animation 

• Sound integration 

• Small memory footprint 

• Clean user-friendly interface 

• Plug-in architecture 

• Exports both QuickTime VR 1.0 and 2.0 

• Photoshop Acquire Module that supports all devices including 
film cameras, (through scanners or photo CDs), digital cameras, 
video cameras and digital video cameras. 

• Supports device (mechanism) software controlled QTVR object rigs 

• Expensive software controlled mechanisms are not required. 
System Requirements: Runs on 68K or Power PC; requires 
allocation of 8 mb real RAM. 

(SWIDG) Our Price $169 
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KAIDAN 

Digital Imaging Technology 

QuickTime VR Authoring Studio is Now Avaiiabie for only $299 
when you purchase selected Kaidan products. 



Get the Q7VRAS for only $299 when you purchase the KiWi+. QuickPan Magnum or Magellan QC. This is a savings of approximately $95 off 
the standard retail price. Sorry, upgrades from the original VR Suite are not available, 

(HOTKB) Our Price $299 




Available only with Kaidan products KiWi+, QuickPan Magnum and Magellan QC. 


QuickPan Magnum 

by Kaidan 


The QuickPan Magnum Series 
consists of two models, the QPX- 
1 and QPX-2. Featured on both 
models is the new QPU-2 camera 
bracket. Based on the highly 
successful KiWi, it provides a 
sturdy, collapsible system for 
the mounting and adjusting of 
a wide variety of cameras and 
camcorders. The new base designs 
used on the Magnums are a refinement 
of our earlier bases, with the QPX-1 having a fixed base and the 
QPX-2 having a new low-profile micro-tilt adjustment stage. The 
easily adjustable click-stops will let you capture a panorama in a 
few seconds. The QPU-2 has two accessories, a Landscape 
Bracket tor positioning the camera in the Mscape orientation 
(QPLB-1) and a Counterweighting Kit (QPCW-1) used to balance 
large cameras or camcorders, such as the Sony VX-1000, that 
have a center of mass well behind the pivot axis. 

QuickPan Magnum-1 ^QPMAGI) Our Price $499 
QuickPan Magnum-2 {HQPMAG2} Our Price $549 


Magellan QC 

by Kaidan 

The Magellan QC is capable of handling 
objects as large as six inches in diameter 
and five pounds in weight, the Magellan 
QC is the perfect choice tor those 
needing to capture small objects at a 
reasonable price. Real-world objects can 
be turned into 3-D virtual reality movies 
using the QuickTime VR Authoring 
Studio and the Magellan QC. 

The Magellan QC leverages the 
capabilities of the Connectix'" Color 
QuickCam"'digital camera tor OTVR 
object capture. The Color QuickCam's close 
focusing capability (one inch to infinity). 640 x 480 resolution, serial 
interface (no video card required). 24-bit color support, convenient 
size and low cost make it an ideal camera for many simple QTVR 
object movies. Using the Magellan QC is easy. Simply locate the 
(toject on top of the adjustable pedestal, perhaps with a small piece 
of double-sticky tape, and then adjust the arms and pedestal so 
that the center of the object is centered in line with the camera and 
the rotation axis of the swingarm. 


QuickPan Magnum Accessories 


(HMAGQC) Our Price $299 


Counterweighting Kit 


Magellan Accessories 


Magellan QC Pedestal Set 

Two extra pedestal tube assemblies, one 2.5" and another 6" 
long. These extra pedestal tobes are used to support objects of 
varying sizes on the Magellan QC. 

(HMAGPED) Our Price $39 

Magellan QC Detent Wheels 

A pair of optional detent wheels (Color = Gold) with 8 (45 
deg). 12 (30 deg), 14 (25.7 deg). 16 (22.5 deg) and 18 (20 
deg) settings. The standard wheels (Color = Aqua) provide 10, 
15,20,24 and 36 positions. 

(HMDWHLS) Our Price $74 


The CountenA/eighting Kit includes a weight and adjustable arm 
that is used to offset the weight of large, heavy cameras and 
camcorders. 

(HWHTKT) Our Price $129 

Detent Wheel 

Detent Wheel (5-inch) (Color = Purple): 10.14.18,24 and 30 
Position (QPDD-2) 

(HQDWHLS) Our Price $49 

QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your panhead or camera 
and your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of 
QTVR/VR nodes in a short period of time. 

(HQTLVLR) Our Price $149 
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KiWi 

by Kaidan 

The KiWi™ 
is the most 
affordable VR/QTVR 
panhead, bringing digital 
photographic panoramas 
to an even wider audience. 

It's the perfect companion to 
programs such as QuickTime VR Authon'ng Studio, PhotoVista and 
Nodester, providing a complete solution for anyone interested in 
adding VR panos to their websites and multimedia applications. 

The KiWi™ consists of two intersecting black anodized aluminum 
struts that adjust and lock lo accommodate a wide range of 
cameras, such as the Apple QuickTake 100/150/200, Kodak 
DC50/120, APS film cameras and 35mm SLRs equipped with wide- 
angle lenses. KiWi™ attaches lo any standard tripod and camera 
equipped with a standard 1/4-20 mounting thread. 

(HKIWI) Our Price $99 




KiWi+ 

by Kaidan 


The KiWi-i- adds a compact, yet 
durable click-stop mechanism and the 
same twin-axis bubble level found on the top-of-the-llne QuickPan 
Magnum Series heads. The twin-axis bubble level (recommended 
by Apple and VR professionals) provides a clear indication of level, 
even when the unit is slightly above eye level. The click-stop 
mechanism uses easily replaceable detent discs, which are 
available in a number of positions (8,12,16,18,20). The KiWi-r 
ships with one disc of your choice and extra discs are available 
separately or as a set, The click-stops speed the process of 
shooting a panorama by eliminating the need for the photographer 
to look at the unit in order to visually align the index increment. 


i 


I 


KiWi -I- Ships with detent disc of your choice 


KiWi-t- with detent disc size 8 
KiWk with detent disc size 12 
KiWi f with detent disc size 16 
KiWi-i- with detent disc size 18 
KiWi-i- with detent disc size 20 


(KIWIP8) Our Price $249 
(K1WIP12) Our Price $249 
(KIWIP16} Our Price $249 
(KIWIP18} Our Price $249 
(KtWIP20) Our Price $249 


KiWi and KiWi+ Accessories 


QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your KiWi or KiWi-i- and 
your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of QTVR/VR 
nodes in a short period of time. 

(HQTLVLR) 0urPrice$149 

KiWi>to-KiWi+ Upgrade 

Includes the necessary parts required to turn your KiWi into a 
KiWi-i- — adding click-stops and the twin-axis bubble level. Comes 
with a detent disc of your choice (8,12,16,18 or 20 positions), 
(HKIWIUP) Our Price $199 

KiWi+ Detent Discs 

KiWi-f Detent Discs are available singly or in a set of four. In both 
cases you get to choose whichever discs you need. 

(HDTDISC) Our Price $24.95 each 

(H0TDISC4) Our Price $89 set of four 

Choices include: 8,12,16,18, or 20 position detent disc 


Landscape Bracket 

The Landscape Bracket is a right angle bracket that allows you to 
mount the KiWi or KiWi-t- upright camera bracket in a horizontal 
orientation. This bracket is primarily used for cameras that have a 
limited field of view and you need to limit the number of shots. 
(HLDBRAC) Our Price $42 

Flash Hotshoe Level 

A dual-axis bubble level tiiat slides into your camera’s hotshoe, It’s a 
useful tool to help level the camera on the upright camera bracket. 
(HFLASH) Our Price $39 

Offset Spacer 

The Offset Spacer is a circular spacer that may be required for 
very narrow cameras (i.e. certain Ricoh digital cameras) in order 
to position the center of the lens over the pivot axis. 

(HOFFSPAC) Our Price $24.95 
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Media Cleaner Pro 

by Terran Interactive 

Use Media Cleaner Pro 2.0 to optimize and compress video for 
CD-ROM, kiosk, or the Intemel. Media Cleaner Pro automates 
your work fiow aiiowing you to get the highest quality video, 
faster and easier than any other program on the market, 

• Includes Adobe Premiere Export module 

• Optimal palette generation, Drag-and-drop batch processing 

• RealMedia, VDOLive and improved QuickTime support 

• Dynamic Preview Window, the Media Wizard, multiprocessor 
support and more! 




System Requirements: 

68040 Mac or better (PowerPC strongly recommended, req'd for 
RealMedia), QuickTime 2,0 or later (2,5 strongly recommended) 

8 Mb application RAM, MacOS 7.0.1 (7,5 or later recommended) 
SoundManager 3.2, CD-ROM Drive 
(SMCP) Our Price $359 


Order Toll-free 
800-MACDEV-1 


P622-33811 


Music Tracks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musical 
introductions, fanfares, background music, 
and more. TTiis collection offers you 100 
music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formate for Macintosh and as Audio 
tracks for audio CS players, All of the music clips are completely 
license and royaity-free!! Mac System requirements: Mac Plus or 
greater, CD-ROM drive. PC system requirements: Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $24.95 




MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music 
CD-ROM for the Mxintosh, This disc is a 
collecBon of clips ideal for Desktop 
Presentations and oilier Multimedia 
applications. This incredible collection of license-free media clips is 
bursting wth 24C+- color pictures and backdrops (PICT), 200+ sound & 
music clips (SoundEdit), 140+ QuickTime movies, and a variety of 
multimedia tools for use writh tine Macintosh. 


(SMWMC) Our Price $24.95 
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} by Lakewood Software | 
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' webAlias 1.0 Is an | 

integrated image map | 


■4iiiiTj itl_i 'h 

editor and anti-aliasing i 

text tool for web and ' 

graphic designers, Use 
, webAlias to create 



*N«t: 

—O'—- ■.,rr, 

«•« a.-tltt 


complete web sites, 

single web pages, and graphic content for muitimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects. webAlias' anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) Our Price $129 


HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 is a hybrid 
multimedia authoring fool and on¬ 
line documentation system for the 
Macintosh and World Wide Web, 

HyperGuide provides Integrated 
searching, indexing and 
bookmarking features. Supported 
media elements include: rectangle 
and scrolling fields, lines and shape fills, most QuickTime-supported 
image formats, anti-aliased text and QuickTime VR movies. 
HyperGuide also includes an integrated screen capture utility and 
user-configurable slide show mode. 

(SHYPGUD) Our Price $149 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

AudioTrack 

SAUDIOTRK 

$270.00 

Be Studio 

SBESTUD 

$99.00 

Captivate 4.6: Essential Graphics Utilities 

SCAPTIV 

$79.00 

ClipVR 

SCLIPVR 

$89.00 

Media Cleaner Pro 

SMCPUP 

$359.00 

Screen Machine 

SSM 

$24.95 
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PowerSD 

by Techworks 

The power of an arcade on your 
PowerPC Based on award winning 
3Dfx VooDoo Graphics, The PowerSD 
works with your existing graphics 
card and muitl-sync monitor to provide you the absolute in 3D 
performance, Install the Power3D in your PowerPC (requires one 
availabie PCI slot in your system} and use the provided pass-through 
cabie to turn your PowerPC into a Power/^cade system! 

PowerSD comes bundied with these awesome 3D enabled games: 

• Quake®: Episode 1 (8 levei) by id Software 

• MechWarrior® 2 by Activision 

• VR Soccer'" by VR Sports (Actua~ for Europe) 

• Weekend Warrior™ by Bungle 
(SPWR30} Our Price $249 


Abuse 

by Bungie Software 
Abuse is 360 degrees of side-scroiiing action, 

Run, Jump, fall and fly in any direction - through 
industrial corridcrs, caverns and sewers. Destroy 
enemies in any direction with grenade iaunchers, 
rocket laurchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and turbo boost! 

Key Features: 

• Point and Kill Interface, Move arxl annihilate mutants in complete 360“ freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scroiling action. Run, jump, fall and fly in 
any direction - through industrial corridors, caverns and sewers 
(SABUSE) Our Price $51 


1000 Games for 
Macintosh 

by BeachWare, tnc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart run-away asteroids, deal yourself that royal flush or 
solve that 3-D puzzle, this disc has It all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MB of available RAM (4 MB of 
RAM when running under System 7). 

(STGM) Our Price $24 


Myth The Fallen Lords 

by Bungie Software 

PC GAMES MAGAZINE’S, Most Anycipated 
New Game Award 

The Fallen Lords is a fully 3D real-time strategy 
game of epic baffle. A mulbmetric game, Myth; 
The Fallen Lords gives gamers unprecedented 
freedom to view their forces, orbiting around 
the heads of a formation or zooming in for a 
close-up on savage melee. Myth: The Fallen Lords Includes maps 
designed for networking, and alternate networking scenarios like 
Assassin and King of flie Hill. 

(SMYTH) Our Price $49 


Classic Arcade s 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, redone 
with killer graphics and sounds! Walkthrough a 
virtual arcade and test your game playing skills 
with these exciting arcade classics. Ten games, > 

including Moon Lander, Astro-Boing, Hyper * 

Hockey, Ballistic Avenger, and more. System Requirements: Mac—Color j 

Mac with 8 MB RAM, CD-ROM drive. PC 486 with 8 MB RAM, Sound ; 
card, SuperVGA, CD-ROM drive. | 

(SCLA) Our Price $24 | 


Marathon THIogy Box Set 

by Bungie Software f 

The Marathon Trilogy Box Set brings all three ^ 

Marathon games together In one affordable package, ; 
with tons of extras thrown in. Besides Marathon, ' 
Marathon 2; Durandal and Marathon Infinity, you'll also 
receive a staggering 1200 maps, featuring never- J 
released Bungie maps and the winners of the Infinity 
Mapmaking Contest, The Marathon Scrapbook (a behind-the-scenes look at 
themaking of the Marathon games). Marathon collectables like the Maraflior 
3-sticker set, and to top it off, the award-winning game that laid the | 

groundwoik for Marathon: Bungle's breakflirough Pathways Into Darkness. ; 

The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the : 

graphics acceleration of 630 and 6200 machines, is 8,16 and 24-bit color I 

capable, and can be played with joysticks and game pads. The package 
requires a 68040 or higher Macintosh, CD-ROM drive, 8-bit color monitor || 
(13" recommended), and System 7 or later. 





(SMTBS) Our Price $65 


, VVAIT*** Here are more products. For full product descriptions please see our Web | 


site, or feel free to call, fax, or E-mail us. 


MoreSy PRODUCT 

CODE 

OUR PRICE 


■.p A Zillion Sounds 

SAZS 

$24.00 


Casino! 

SCAS 

$24.00 


Night Sky Interactive 

SNSI 

$24.00 


Trivia Warehouse 2000 

STW2K 

$24.00 





Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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GeekWare"* 

You live it, you breath it... you 
might as well wear it! (xl only) 



Alien T-Shirt 

(AALIEN) Our Price $ 9.95 

Arnold T-Shirt 

(ACWARNLO) Our Price $ 9.95 

Arnold Jr. T-Shirt 

(AARNOLDJR) Our Price $ 9.95 

Blood, Sweat & Code T-Shirt (SS) 

(ACWSBLOOD) Our Price $ 9.95 

Blood, Sweat & Code T-Shirt (LS) 

(ACWLBLOOD) Our Price $ 14.95 

CodeWarrior Baseball Cap - Black 

(ACWBHAT) OurPrice $ 14.95 

CodeWarrior Sweatshirt - Black 

(ACWSWEAT) Our Price $ 29.95 

CodeWarrior Hawaii Fhre-O Shirt 

(ACWHAWAII) Our Price $ 9.95 

CodeWarrior WintH' Hat 

(AWINHAT) OurPrice $ 14.95 

Debugger Boxer Shorts 

(ADBOXER) OurPrice $ 16.95 

Discover Programming T-Stiirt 

(AOiSCPT) OurPrice $ 9.95 



Now you can have laptop stabiiity, drop 
protection & mobility, If you’re looking 
for an Inexpensive, non-technicai gift 
for a iaptop owner - look no further 

• Strap your iaptop to your ieg 

• Universai size - fits aii laptops and 
all legs (13"-46") 

• Velcro Velcoins attach your laptop to ttie pocleum 

• Podeum allows working angles up to 90 degrees 

• Dropped laptops account for 41 % of all laptop fatalities 

• Manufacturer's tifetime warranty, 


Podeum Sport 

by Rach, Inc. 


(APODSP) Our Price $39 



MacTech® Mouse Pad 

Slide on thisi With an extra-large surface (11" by 10") and 
a deluxe sleek plastic coating, you'll be zooming across 
your screen in no time at all. Speed limit not enforced! 

(AMTPAD) OurPrice $ 8.95 
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for ^acinto^h 
Programmen & Developers 



MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they 
need to know about software development. Topics like Rhapsody, Java. 
QuickTime. OPENSTEP, Objective-C. C/C++, Object Oriented Technologies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues; each plus shipping (subject to availability) $10 




MacTech® CD-ROM Volumes 1-12 

• Includes Apple’s issues 1-29 (1990-1997) 

• Almost 1600 articles from all 139 Issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of THINK Reference™*—the original online guide to Inside Macintosh. Vots. 1-VI 

• 80MB of FrameW/orks/SFA archives and the most complete set of Frameworks archives knovm 

• Sprocker^l MacTech's tiny framework that compiles quickly and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 



Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. Includes: 
QuickDraw^” GX Library, Macintosh Human Interface 
Guidelines. PowerPC System Software. Macintosh Toolbox 
Essentials and More Macintosh Toolbox, QuickTime and 
QuickTime Components. Access over 16.000 pages of 
information with Hypertext linking and extensive crr^ 
referencing. 

PMCD) Our Price $89 



Order TelMree 
800-MACDEV-1 

nOO«72-13S1| 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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TiltLfua Vidliinie 2 

jwmjippki jinajiM jqwtJKflU 



The Java Class Libraries, 
Second Edition, Volume 2 

by Chan Lee 

This hook is intended as a reference rather 
than a tutorial. Its format is similar to a 
dictionary’s in that it is designed to optimize 
the time it takes for you to look up 
information on a class or class member. The 
classes in this book are ordered alphabetically without regard to 
package name. This makes looking up a class as straightforward as 
looking up a word in a dictionary. Each class is described in its own 
chapter. Each chapter contains a picture of the class hierarchy, a 
class description, a class example, a member summary, and 
descriptions for every member in the class. 

(BJCLAS^ Our Price $44 



AppleShare IP: 

By Tom Dell 

This book is for administrators either using or 
planning to use Apple’s new networking 
system, The book discusses choosing 
servers, configuration, access privileges, the 
AppleShare file server, print service, e-maill, 
web services, /^ple Search, MacDNS and 
interfacing third party products. 

• Discusses choosing a server and the AppleShare file service 

• Cover AppleShare IP support for PCs 

• Addresses AppleShare IP e-mail, web and print services 

• Includes hands-on exercise and one CD-ROM for Macintosh with 
and AppleShare IP Administrator’s Toolkit 

(BSHARIP) Our Price $35 


Interface Design: 

By Peter Bickford 

This book is a practical guide for designing 
software with users In mind. It offers an on- 
the-job view of what it takes to create great 
products, offering practical tips and advice 
instead of forcing the reader to extrapolate 
from abstract psychological theory, interface 
Design targets a wide range of design issues, from taming the 
incomprehensible interfaces of database systems and the Internet, 
to using sound and animation effectively in multimedia. Throughout 
the book, the author offers techniques for controlling the growing 
complexity of computer software, and makes an impassioned case 
for intelligent design based on the real need of users. 

(BINTER) Our Price $31 




Be Developer’s Guide 

by The Be Developement Team 

The Be Developer’s Guide is the official 
programmer's reference manual for the 
BeOS, a revolutionary new operating system 
built around muttimedia, threading, and 
multiprocessing. Essential reading tor anyone 
who wants to design runnable applications 
for the BeOS, this book describes and explains how to use all the 
development kits, providing muttimedia developers access to the 
internals of the first new operating system in years. 

(BBEDEV) Our Price $45 

The OpenGL 
Programming Guide 

by Mason Woo, Jackie Neider 
and Tom Davis 

• Coverage of the new features of OpenGL, 
Version 1.1, including all texturing changes, 
vertex arrays, polygon offset, and RGBA 
logical operations 
' The incorporation of the OpenGL Utility Toolkit, GLUT, in ail 
programming examples an overview of the OpenGL rendering 
pipeline and state machine 

' Enhanced coverage of polygon tessellation, quadric surfaces, pixel 
operations, and error handling 
More performance tips 
A greatly expanded Index 
(BOPGL) Our Price $39 





The Java' 
FAQ 


The Java FAQ 

by Jonni Kanerva 

Java FAQ provides an insider’s view of the 
Java™ technology by posing 
and answering the most important, frequently 
asked questions about the Java programming 
language, Java applets, and Java stand-alone 
applications, The Java FAQ is unique in that it 
draws from the tens of thousands of questions sent to 
<Java@java.sun.com> and provides authoritative answers direct 
from the creators of the Java programming language at JavaSoft. 
(BJFAQ) Our Price $25 



Order Toll-free 
SOO-MACDEV-! 

iS00622-3381| 


22 1-800-MACDEV-l • Outside U.S. & Canada: 805494-9797 • Fax: 805-494-9798 







































Getting Started With WebObjects 

by Apple Enterprise Software 

It you're a first time user, start here to learn the bastes of how to 
create and run WebObjects applications. 

(BGSWO) Our Price $14 

WebObjects Deveioper's Guide 

by Apple Enterprise Software 

A guide to building and understanding WebObjects applications. 
Takes a close took at the WebObjects scripting language, Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Developer’s Guide 

by Apple Enterprise Software 

Distributed OLE is available today, and this book shows you how to 
use it. Using reaPworld examples, the book steps you through the 
process of making your OPENSTEP objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering OPENSTEPi Mach 

by Apple Enterprise Software 

introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the aeation of three applications of 
increasing complexity. The tutorials demmstrate and explain 
programming techniques. Objective-C fundamentals, common APIs, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. Ific book also 
includes a chapter directing readers to programming resources, 
further information, and services such as training and support. An 
appendix offers a concise discussion of (^ject-oriented programming. 
(BDOSTEPM) Our Price $15 

Discovering OPENSTEP, Windows 

by Apple Enterprise Software 

Discovering OPENSTEP provides an introduction to OPENSTff 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way, 
it explains concepts and illustrates aspects of Objective-C, OPENSTEP 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) 0urPrice$16 


Object-Oriented 
Programming and Objective C 

by Apple Enterprise Software. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
Objective-C is easy to leant and use because it adds very little 
syntax to Ute C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Worldng w/ Interface Builder (for eof) 

by Apple Enterprise Software 

A hands-on, award-winning book designed to help you get your job 
done with the updated interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 
NEXTSTEP, 

(BWIB) Our Price $24 

Using EOF 2.1 Vtf OPENSTEP (Mach & Windows) 

by Apple Enterprise Software 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP. It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mach & windows) 

by Apple Enterprise Software 

The Biterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. It includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer's Guide tor EOF 2.0 (BE0FDG20} Our Price $24 
EOF Deveioper's Guide for EOF 1 .X (BEOFDG1X) Our Price $24 


Web site: htfp://www.devdepot.com • E-mail: orders@devdepot.com 
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Rhapsody 
Developer’s Guide 

by Jesse Feiler 

Covers the basic architectural principles 
of Rhapsody: the Mach microkernel, 
object-oriented programming, and the 
elements of a modern OS such as 
preemptive multitasking, protected 
memory, and symmetric multiprocessing. 
Also shows ways of getting to this new environment—Objective C, 
conversion tools, and the integration of Java—to develop Rhapsody 
products. Paperback, 450 pages. 


(BRDG) Our Price $35 


Building An Extranet: 
Connect Your Intranet With 
Vendors And Customers 

by Julie Bort and Bradley Felix 

Building an Extranet will help companies use 
their Intranet capabilities to supply information 
to elected customers and vendors through a 
secure Extranet. This book provide complete infonnation and working 
details for building the netwoi1< behind Intranets and Extranets, 
designing the applications, and getting everything up and running. 
(BBLDEXT) Our Price $26.99 




f Mugging^ 
Software 


Debugging Macintosh 
Software 

with MacsBug ( O 




KUN.SI A \ I l^ rn llMl.H 
fIM NTPtAUS 


by Konstantin Othmer and 
Jim Straus 

MacsBug, from Apple Computer. Inc., 
is the leading debugging software 
program for the Macintosh. This 
book/disk package is an all-in-one kit 
tor using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31 


iHiatliSiSli Uii; 
SEtlllK HORF 
lUteSlIF 


Increasing Hits and Selling 
More on your Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and tricks 
you need to know to make your site a commercial success. 
(BIHSMWS) Our Price $22.45 


Check out our Web site! 


• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Effective C-I-+, 

Second Edition: 

50 Specific Ways to Improve Your 
Programs and Designs 
by Scott Meyers 

Effective C4-+. 2nd Edition includes: Expert 
guidance on object-oriented design, class 
design, and the proper use of inheritance 

• An examination of the standard C-n- library, including how the 
Standard Template Library and classes like string and vector affect 
the .structure of well-written programs 

• Discussions of late-breaking language features like in-class 
constant initializations, namespaces, and member templates 

• Wisdom usually possessed by only the most experienced 
developers 

• Effective C-h- continues to be essential reading for every 
developer working with C-^+. 

(BEFFC) Our Price $34 



The Official BBEdit Book 

by Bob LeVitus and Natanya Pitts 

The Official BBEdit Book makes it easy for 
today’s Webmasters to speed their own 
interactive development projects using this 
powerful editing environment. Bare Bones 
incorporates features like floating palettes. 
HTML support, and syntax coloring to 
enhance an already extensive feature set, making BBEdit a leading 
Web authoring tool. Super-fast text processing, easy scripting, wide 
extensibility, strong GREP-style search-and-replace capabilities, and 
support for 13 languages make rl easy to see why so many Web 
developers use BBEdit as their primary authoring tool. 

(BOFBB) Our Price $35 



TKt Official 
BBEdit 
Book % 
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Practical Object- 
Oriented Development 
in C++ and Java 

by Cay S. Horstmann 
This book offers advice on real-world 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design, C-r-t-, and Java in a way that makes these potentially 
daunting operations more accessible than they’ve ever been before. 


(BPOOD) Our Price $31 
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DeBabelizer 

by Lise Despres and Paul Vachier 

DeBabelizer: The Authorized Edition is the 
official guide for Web designers, 
multimedia creators, artists and production 
specialists who want to take advantage of 
this powerful tool. 

• Create graphics and images for the Web &iat download fast and 
look amazing 

• Optimize graphics for CD-ROM, video, and animation 

• Optimize and manage colors using tfie SuperPaIette(TM) 

• Discover DeBabelizer tips and advice from industry experts 

• Master basic manipulation techniques, including rotation, scaling, 
cropping, and text overlay 

• Explore key production techniques in all areas of graphics 
processing 

(BDEBTAE) Our Price $39 
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JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to 
show you how to turn 
Netscape into your own 
personal, customized 
operating system, 

Provides the inside tips and 
techniques for making your Web pages much more attractive. 
Shows you how to use all of the key features of the JavaScript 
language, including objects, methods, properties, events, and 
much more, Includes CD-ROM with numerous interactive scripts 
written in JavaScript you can add to your Web pages today, A 
complete set of the best Java applets. Useful plug-ins designed to 
supercharge Netscape and resources to help JavaScript 
programmers. 

(BJNWIZ) Our Price $31 



Designing 3D 
Graphics 

by Josh White 




In this powerful book/CD-ROM package, 
top computer graphics artist Josh White 
tells you everything you need to know to 
create sophisticated real-time 3D 
graphics for computer games and 
virtual reality, This book contains the In- 
depth knowledge of software tools and hands-on modeling 
techniques that Josh White has learned while creating artwork for 
over 20 commercial games, including Descent, Zone Raiders, Locus, 
Legoland, and others. 

(BD3DG) Our Price $35 


Web site: http://www,devdepot.com • 


Linux Configuration ^0^ 
& Installation, 

3rd Edition 

by Patrick Voikering, Kevin Reichard, and 
Eric F. Johnson 

Linux, the leading UNIX variant, has garnered 
loads of attention within the UNIX community. 
The amaang thing about Linux is that you 
don’t need a workstation to run it, Linux Configuration & Installation, 
Second Edition lets you run Linux today. Program with Linux using C, 
C-H-, Perl, and Tcl/Tk, The 2 CD-ROM pack offers one of the most 
popular Linux distributions, Slackware 96, and comes directly from 
Patrick Voikering, the creator of Slackware. 

(BLCI2) Our Price $35 

Symantec Visual Cafe 
Sourcebook 

by Cary A. Jardin and Pam Dixon 

Symantec Visual Cafe, the first visual Java 
development tool that gives programmers a 
sophisticated set of tools. This book teaches 
programmers how to use Symantec Visual 
Cafe to create Java applets. It provides a thorough introduction to 
the language and gives advanced Java programmers information on 
how to use Visual Cafe to create their own Java development tools. 
(BSYMSOUR) Our Price $35 

HTML Sourcebook, 3rd 
Edition 

by Ian S. Graham 

Critics everywhere agree, HTML Sourcebook 
is the best guide to HTML for Web 
professionals, That’s because no other book 
makes it so easy for you to quickly master 
all the commands, tools, and expert 
techniques you need to create cutting-edge Web page documents. 
Completely revised and expanded by nearly 50 percent, this new 
third edition of the best-selling guide to HTML gives you the 
complete lowdown on all the changes and enhancements to the 
HTML, HTTP, and URL standards. 

(BHTMLS) Our Price $26.95 


Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add Interactivity and multimedia to Web pages! 

A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 
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Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentiais. 
byAppie Computer 

Get quick access to reference pages for over 
4,000 Tooibox calis in your system software 
from ttieir deveiopment environment. Essentiai 
information for Macintosh software deveiopers. Hypertext links allow 
programmers to view related topics easily. Ttie ultimate electronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89 



Web Publisher’s Design 
Guide for Macintosh, 
2nd Edition 

by Mary Jo Fahey 

This is the only hook that takes you 
step-by-step ttirough real projects 
designed by talented new media artists, 
internet design experts share their 
design secrets and art files (look for art 
files on the companion CD-ROM by artist's last name). This expanded 
new edition includes Photoshop, Illustrator and DeBabelizer tricks 
from the first ediflon plus countless new ways to liven up your Web 
pages with 30 graphics, sound, movies, and much more. 


(BWPDG2) Our Price $35 



HTML ForTheWorid 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You'll 
be up and running in no time. If you 
need to learn HTML fast - this is book 
Is for you, 



(BHTMLW2) Our Price $16.15 

Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 

The complete resource for creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
create Shockwave movies and put 
them on the Web, Expert tips from the 
creators of Macromedia’s first 
Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 



Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a few of the topics 
you'll learn include: using search 
engines with URL’s; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key internet contacts. Wifri biis book, 
you’ll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHITS) Our Price $17.95 


Getting Hits^The 
Definitive Guide To 
Promoting Your Website 

by Don Seilers 



Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembiy Language 

by Gary Kacmarcik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35 

JavaScript For The 
Worid Wide Web 

by Ted Gesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know, 

(BJWWW) Our Price $16.15 
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WebMaster in a Nutshell, Deluxe Edition 


by O’Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster’s toolbox, The CD-ROM contains the Web 
Developer's Library—the full text of the latest editions of five 
popular O’Reilly titles; "HTML: The Definitive Guide, 2nd Edition"; 
"JavaScript: The Definitive Guide, 2nd Edition"; "CGI Programming 
on ttie World Wide Web"; "Programming Perl, 2nd Edition"; and 
"WebMaster in a Nutshell." The Deluxe Edition also includes a 
printed copy of "WebMaster in a Nutshell," fine all-inclusive quick 
reference that belongs next to every webmaster's terminal. Includes 
CD-ROM & 356 page book. 



Requirements: The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNUTD) Our Price $62 
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CodeWarrior Software 
Development Using PowerPlant 

by Jan L Harrington 



C++ programmers will learn to develop object-oriented software 
applications for tbe Mac and Power Mac using tbe PowerPlant 
environment and the classes that support 11. Covers CodeWarrior 8. 
Included CD-ROM contains source code for all the programming 
examples in the book and Metrowerks CodeWarrior Lite. 

(BCWSWDEV) Our Price $31 




JavaScript 1.1 
Deveioper’s Guide 

by Arman Danesh and Wes Tatters 
Written by developers for 
developers. An advanced 
guide to crating 
professional Web 
applications with 

JavaScript 1.1 eb deployed in Netscape 
Navigator 3.0, Microsoft Internet Explorer 3.0, and LiveWire. Includes 
CD-ROM with Sun's Java Developer's Kit, JavaScript and HTML 
Editors for Windows and Macintosh. 20 contributed neady-to-run 
JavaScripts and JavaScript examples from the book. 


(BJSDG) Our Price $44 


Web Security Sourcebook 

by Aviel D. Rubin, Daniel Geer and Marcus 
J. Ranum 

Technical tools and techniques for 
building secure web sites and 
applications 

This book shows web masters, web 
managers, and web designers the hands on 
programming techniques necessary to build secure web sites. 
Readers will lej^ how to secure the server, use firewalls and 
cryptography, write secure Java applets and CGI scripts and more. 
Companion Web Site includes source code examples plus updates 
on the latest security threats and techniques. 

(BWEBSER) Our Price $26.99 

Wireiess For 
The Newton 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code tor a Newton application, 
as well as demonstration NTK - the complete development 
environment for the Newton 

(BWIRELESS) Our Price $31 
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Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.coiii 





C++ Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 


(BCPPCW) Our Price $33 


-LearnConThe 

Macintosh, Second 

New revised edition! Easy-to-understand - 
everything you need to start programming. 
Updated and enhanced exercises that lead you 
step by step. You'll learn function, variables, point datatypes, data 
structures, file input and output and more! Includes CD-ROM with 
Metrowerks CodeWarrior^^ Lite. 

(BLEARNC2) Our Price $33 



The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer graphic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resorting to mind-numbing equations and 
Impenetrable technical jargon. 

(BWCGW) Our Price $29.65 
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Inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of meyor PowerPlant classes 
and resources. Included are the PowrerPlant Constructor Manual, 
including View, TexfTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BINSPP) Our Price $34 
SEE RELATED CATEGORY: Dev. Environment 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference tor anyone using AppleScript to modify existing scripts or to write 
new ones. Contains useful information for programmers who are working on scriptable 
applications or complex scripts. Features detailed definitions of AppleScript terminology 
and syntax in the following categories: Value classes, commands, objects and 
references to objects, expressions, control statements, handlers, and script objects. 
Includes many sample scripts, discusses advanced topics such as writing command 
handlers for script applications, the scope of script variables and properties declared at 
different levels in a script, and inheritance and detegation among script objects. 

(BALG) Our Price $26.95 
SEE RELATED CATEGORY; Scripting 
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Special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 

This complete reference provides 
professional Web developers and advanced 
personal users with the latest information 
on using CGI (Common Gateway Interface} to interact virith databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUC6I) Our Price $44 

JavaScript for the Macintosh 

by Matt Shobe and Ttm Ritchey 

Allows non-programmers to take 
advantage of the power of 
Netscape Navigator. Expand the 
capabilities of your Web page, without 
having to understand C or C++. CD-ROM 
contains "Wizlets" that allows you to easily 
create your own JavaScripts. Takes you step-by-step through 
programming cross-plattonn JavaScripts. Details how to create 
JavaScripts for JavaScript-aware Web browsers. 

(BJAVASCRPTJ) Our Price $40 
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AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O'Hara 

Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
"Mac-Like”, Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1. a demonstrations version of 
FaceSpan 2 . 1 , source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan, 

(BAPSCAP) Our Price $31 

Java in a Nutshell, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1, both on a package-by-package 
basts and In terms of overall functionality. A 
comprehensive tutorial on "inner classes” 
that explains how to use all of the new types 
of inner classes; static member classes, member classes, local 
classes, and anonymous classes. Practical, real-wodd example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, the new AWT event handling model, 
internationalization, and a sample Java Bean. 

(BJNUT2) Our Price $17.95 

AppieScript Finder Guide^ English Diaiect 

by Apple Computer, inc. 

Provides definitions tor Finder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 

Inside CodeWamor Professional 

by Metrowerks 

Includes CodeWarrior IDE User’s Guide. This is the printed version of the 
documentation provided on the CO. Covers CodeWarrior Professional 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34 

SEE RELATED CATEGORY: Dev, Environment 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics Into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

(B3DGFIAP) Our Price $35 
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IKcks of The 
Mac Game 
Programming Gurus 


by McComack, Ftagnemalm, Celestin, el al. 
For beginning to expert game 
programmers. Complete overview of all 
the necessary components of game 
programming on the Macintosh, Packed 
with valuable tools, utilities, sample code, CodeWarriorT“ Lite and 
game demos. QuickDraw 3D and Power Mac optimization and inside 
info on how Glypha ill was created. Hundreds of tried-and-tme 
tricks, tips, and insider secrets from well-known Mac game 
programming experts. 

(BTRICKS) Our Price $45 


Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software’s color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference information in both 
QuickView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) Our Price $33 


Black Art of Macintosh 
Game Programming 

by Kevin Tieskoetter 

Develop your own 3D games in '' 

C on the Mac. Includes CD with 
project files for both Symantec 
C and Code Warrior. Create **® 
freeform texture-mapped games and 
polygon graphics, Control dynamic source 
code—all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35 
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Appl^xipl Afi|ilicatiniKi; fii uidinq AfiplifcaJinfK w/Fnm^Lin. 

....bapscap. 

.$31.00 

Tlie Power of Pnigrapfi CPX....... 

.bDANPRC 

..19.95 

C+-X-Ptngfaminiriig .. . . 

.. BCPPWlACAP..... 

.31.00 

VVaual Pmorammirg wtti FVograpti CPX.... 

.BVWFHO. 

...30.00 

rJTj. o-RnK llt^rVifiiiiffc ,. 

. ..... ... BCPPIOT 

29.00 

Wirefess For The Mewton......... .. 

..WMffftglFSS 

:ii m 

fjmHHWlimnf IncirlH PtnurvPfexnf .. . 

...RINSPP,,.... 

. J4,O0 




Cyberdog Priagrami™o W ....... 

...GtMSIRDOG .... 

.34.00 

Hantware 



Oait Shafer Presanls tile Power ol Prtjgrapli CPX._. 



Arfilflltll-HnMMarwIhnr* .,. 

.JCUHAND. 

.....14.36 

inskfe CodeWanlar Book..... 

.. 

.BINSGW..... 

. 

..............34.00 

Ctesjgrlug Car* for the Mac-iptesh. 

.BCAHD,.. 

.,^.26.96 

ifBtant COFffiA_.... 

..^ic.. 

.17.99 

1 HsaWritflr Reffirenm ... 

.RiASPRflfF . . 

.„.17.96 

Last Resort Progimimflfs EdHion .... .. 

........BLSIBERT.. 

.74.00 

PPt ^^y^iffifn Amriitflnliirft f^nil Frtitlnn .. 

... RPfilfiVS .. 

.31.00 

Madrttosb C P^OlE]^amlyl^I59 Primer Voiu™ 1.. 


.. 24.25 

PnwiRrPf: PysJHfn Arnhitefrii ipr.. 

.BPPCAflCH. 

.31 00 

Maclnftosh C Pnofiramming Primer Votume 1......... 

. 

... jcpniMz. 

.........24.25 




Madrutosti Pascal Pnooramminfl Prinier VolLUie J.. 

.iJPASCPHl. 

.-2425 

Internet Related 



Mastering trie Tbink Class Ltera/y. 

.....BMASTtma.... 

.. ..26.95 

IflfM Irtriniwt Wliili* Payi^i... 

. . ...BSMWtirn:. 

.26.05 

Ma.'^fijlng Ihn Tnnflimf 11'ang THlWk C . 

BCP™M2 

242S 

ArlivE .Liv;].. ..... .. 

. FtAfT.IAVA 

.23L36 

flh^l-ritflenlwl Pmgrsmmkng 

BOBJCOOPT 

,,34.00 

Aruerii:n Oulkie ftw DtiuirniES ..... ... 

. RAniniM 

..J7J5 

PrcscnongMagic.Cap. ...... ... ............. .. 

BPRESMACIC 

1525 

CO By rxainfte.....___ 

.. ...BCGIBC.. 

.31.00 

Real ^Irt Apple Guide... 

.JftAIMX]. 

.35.1)0 

Btjilding ^ Mhinlairiing Inlraiiet w/ Ihe Maonlosh.. 

.. .„„B8AMAt.... 

.45.00 

SymantET. C-l-i- Prftgrijrrimmg. 

.BSYktCPP. 

__ ,.,.30.00 

njaria Hftnnfl Piigp finmfBf^.. 

.Ftrwx!. 

...26.95 

Talinfmt'.'! fit lirte In np^(irii™i PFumsms 

RTA^ IfiFfJT 

17.5S 

Ofmpotet Phviacy HiarnHiook ...» 

RPfflW 

.22.45 
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_,,prrsCaA 

26,05 

LaserWriter Reference..,,,...... 

JUtSERREF,. 

.J7.96 

E-Mal Essentia ■«. 

....BEMAILE. 

. 22AB 

Leaff^ ofj Maciniosii ....... 

.nmnpp. 

. 35.00 


mAUL 

13,45 

1 fijifn C Him ftifl Marinin!^ l!;rP{fitim ^ ^ 


31 00 

Hookedon .. ..h-.. 


... .2G.9S 

Leam C ontbe Macintosh, 2no Edbori 

.„0l£AflfC2. 

.33,00 
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.. 

iMSMIir 

.. 13,45 
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.JtittCOUM. 

.17JS 

IntBnwlBcBlf,.,,,,,...... 

....BTTfT.“H „ .. 

. 22.50 

MadntDdi C Ptogrammei Piirw Vciutnei 1 ..... 
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iretfimal for IXimnies 2iid Etfton...... 

_ptfUlp® 

. 17,99 
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.5425 
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.8.05 

MndnlnBi Hi F? Prog Woritwig idth Qh|H:k . 

an F? 

mm 

JnJiefnflt tof Macs lor Dummies.. . 

RHRTtai 

17,95 
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npA.^mt> 

.........2425 

tttemat for lar [kittmlis Bests^ .. 

...BflURlBE.......... 

.35,00 

Maoilosf] Prograrrvnjfig Saemts 2nij offlion..... 

.. 

28,76 

Internet PowsT Tools.,..K,.. 

. pri^TTmni. 

.,..38.00 

Madntosh Prpgramning TedriqMes. .. ,,,,,.. 

™„«,. _BPTTCH.. 

.31,(W 
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.... JRtfiW .. 

.38,00 

Mb^osoft VisuBi i++1,1 SourodMOk... 
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......errctUK........ 
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.,™_JM0BETE!CH. 
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.BKTWD... 
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.. ... 
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.....__ 
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Object OHentad Progfammino Design .... 
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.....20J6 
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. .31jOO 

Sertp^ng and Solirdoris 



DarviyGoatnan'sMacbash itand^ ... . 

.JGDOati. 

.26J5 

AppleSodpI Apoftoettins: Dudding Ages with FeoeSpiHii.__ 

..BAPSCAP.. 

.. 3taM 

Fi^nCWkks SikJite Code Disk-, ■■■,, ,iii,i,i,iiii,,iiiji,,,i,,.i,,,,,,,,.llll. 

..-MITWSC. 

.9J95 

A(^Sfirip[ 

flsnftAnn 

... 17,05 

CrjHiwWob Maga/im Ebii Issui_ 

..Mli-WBACK. 

BjOO 

Applied MaSntosii ficilptlnQ:... 

. liApptim. 

...,J1.00 

tlraphk! 7 . . 

.. RfiFMS?. 

..44,00 

Complete H>pcfCard 2:,2 Handbook..... 

..SHYPCRO!?. 

...J1.00 

Gr^ic Gams 4 ___ ___ ______ 

.0GEMS4...... 

..44.00 

CompMio HjporTalk 2.2:. .. „ ... 

..... SHYPCflOfi. 

.31.00 

Graphic Gerra V______,,...,_,.. 

........ .BGEMS5. 

.. 44 .00 

npnrv|t iVwknnn'fi Af^n Iii ikim <^nrl(>r Kit . 

. RnfiA^dt . 

...31.00 

infjfii-D Revested -...—... 

...BINFnRFV.. 

.40.00 

HyporCard Stadii Ocsigh..... ........ 

___BHVPSTA. 

. 19.55 

irBide Director 5 w® Ungp tor Madhtosh;... .. 

IrvlBrlace Design . . , . 

..01O5WLM. 

..44.00 

JavEiScftpl! for Macinlosh.. ................. 

FtlAUASraPT 

40 00 

BiffTFfl. 

..31.00 

Perl Oulek fleferooce..... h.,khhh«.h. 


...17.99 

Late Night wUh Macttach............ 

.....B|,ATr. 

_25.95 

Rial Wwkl ApfilB Sukte... . 

...AlFfllWl n 

.35.00 

Man HafttBnrire JteadRf . .. 

.- .nflADl. 

..11.70 




Macrornedla Mnector Ungo Workshop, 2hd EtWon. 

.JM0LW2. 

. 4QM 

Tecfifiicai Reference 



Mac Screamer The UlimEtB MacinitBli SopcrchaigaTg IQt.. 

. _... ,..BSCRCAM ,.. 

.3TJOO 






Active ,^tia.... 

hactjma 

...,23J8 

Mncirttipsn rrASft Pkjnw .....■ -.. 

iimsM 

gfiBS 

A{^naVRnMH»fiit«* 

wnHftnn 

-„.14.36 

SAarTw* Rank Nstfse 

....MTBAOaSS.. 

.,.,tO,DO 

ArvieShva IP..-,.,..... 

JSHAftP.... 

.35.00 

UacttrMiriilllkmafbs.M»vB»Si pTf^ _.,. 

. .JUITMAC. 

3SJQ0 

Aft of Human kterfsce TJmigft __ . __ 

.. mm... . 

.29,65 

MADAnrwgr^fTt-flnM 

..SMAO^. . 

. MM 

Db DmskiFur's GuUa. 

fiflpnRi. 

.. 46lOO 

Mullifn^ Authoring: BuAckng and Oevekiping Documonti—....,. 

..-BMMLTrH. 

.31 JO 

BtKk Art of Mac Game PFogrammlng .... 

....BBLAGK.,.. 

..3S.00 

!>l|^irtF!r k^ hr Uarintwii. 

...BiiiieiAHT .. 

.27.00 

C-M-lor Oumoiies..- -. .... . 

.. ..flCPPtSUM.... 

.22.46 

Pmfi knm Pipprienra!_ _ 

.BPHOfTT. 

.^45 

Cfor DufmiMsIftH 1. -i.. 

.dCQUM. 

.17.9i5 

RfisTtf! Fkwvfvl Frfitlwi . 

.HESD2.. 

.JIJB 

Ceveioping Oti||ect Orlentcsd Softv^ tor the Modr^o^.—__ 

„ ..... ..BOEVOe. 

.26.06 

Sad Mans, Bombs and Difiastera _ _ . _ . _ 

....BSADhiAC... . 

™.,-,a2is 

fTrtiwirtlng ttw Ubr TniVlTO ____ 

, . .bftmt 

.22.46 

Standards For OnloB Pjimiriiifttraittrifi ,,. .... 

B3=0C—... 

..4aoo 

Foundations of MiicIntDSh PrograovT^ng....... 

......BFOUND. 

3&00 

Th« Eterwnte pf E-MaH Style........ 

....BOiWL. 

.. 1345 

Fraigriierit of Ybiir (rrta^^ .. 

...flFRftfi. 

.35lOO 

The Software Devekiper's & Marketer's Lagal Comparlon 

Tog on Seftwaro DeSbi .... . .. 

..BSDAMLC,... . 

33,00 

GiAde to Macintosh Software LocaliJition.. 

..aOGALtJ. 

.24,26 

..BTOG.. 

.2a56 

Guide to Madntosh Systioni 7,5.......... 

..0SVS7.5.... 

.22lSO 

Tricks of the Mac Gama Gurus.... -... -... .... 

....BTRICKS. 

.45J0 

Inside AppleTalk....... 

...BAPTALK. 

.31.00 

Zen ana the Art of ftesaurice Editing.,,,„,,.. 

..GTAAOfiE.. 

..27.00 

Inside the Macinteh CommurUcsfioos Tootbo?f...«... 

---0COMM. 

.22.45 
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All entries in this index are alphabetized. For your convenience the product nannes 
are bold, book names are italicized and company names are in plain text. 


1000 Games for Macintosh_ 

3D GrBptdcs Usii-ig QuickDraw 3D 


.19 

. 29 


AAA+ Softwane,. 


Abaoft Corporaticri.. 

Atxise... 


Adamation........ 

Additiofial Listings for Development Enviranments^ 

Additional Listings for Games. 

Additional Listings for Internet........ 

Additional Listings for Multimedia.. 

Additional Listings for Tools, Ubrarres & Utirities^ 

Adiantainc........ 

Actvancad imaging on the Mac €)S . 

AG Author____ 


Aitiira ScfftwarB. (nc........................................................ 

Appt Enterprise Software... .............. 

AppfeScript AppScaiions: Buikjiftg Apps w F&ceSpan^App^Scrpt. 

AppleScript fhderGukie, En^sh Dtatecf............. 

Apf:^wo IP.... ....... 

AppfeScript Language Guide ..... 

AppMaker.. 


.....3 

...19 

.9 

...19 

...13 

,..18 

«.11 

,..10 

..29 

.-10 

.5 

..23 

..28 

.28 

..22 

..9 


De.^gTing 3D Graphics..... .. 

Di^ Technology International. 

Digitool. Inc..... 

Discov&ing CPENSJEP Mach . 

OPBfVSTBF? WWowS.. 
DynaMorph 1.5»..„,..__ 


...25 

..14 

..3 

.. 23 

.......S3 

. .14 


EfhctMs C++, SecondEdiban..... .. 

EOF Devefoper's Guide itx EOF2.1 {Madi 3 Wftiobws).. 

EjtposurePro*. 


M n+M Pfr 


..24 

..23 

...16 


FaceSpan v3.0. 
Future Basic ri.. 


..14 

„10 


GeekWare™.... 

GenieWorks, LLC_____........ 

Get^ Hits-Jhe Definitive Guicte To Promo^ Vbtr 
Getting Started Wtm W^rOt^cts ........ 

Guide Composer^'^ 1.2.. 


«20 


..-.B 

.26 

. ...23 

-12.15 

- 8 


AudioTrack.... 

. __ -- ___ -.18 

■ —H- 

— 



HTML For The Wbritf Wide WPb, 2rtc}Edtion.. .—..— 

......26 



HTML Sourcebook, 3rd Edtiorj..... ...-. 


B-fi^e HELPER 2^ .. 

.. ..a 

HyperGutde 1-0.. . 

19 1A 

Bare Bones Software.... 




BBEdH4.5.. 

___ 12 

■ 


Be Basics—.. .. 

__, . _11 

Increasing Hits and Sf^&rrg A4nre on ymjr VWsh Ste.. 

... 24 

Be Ctevafc^per^ Qjole,-...-__ 


hiedtice O^i^.................... 

.......22 

Be. he.. 

........... 3 

hsifcte Codel/l/afriar Rrnfe^^ .... .. 

—...,.„28 

Beale Street Groupp Inc. 


/nshh Macinto^i OP-FinM...... 

......2T 

BeOs Preview Release 2 



. . 27 

BeachWaro, \rc.... . 

.........7p 18.19 

.... , ...i.. . 


BeatWare ....—.. 

.......... 




BeSpocific 3 ... 

Back Art ofMadntod} Game Pre^armmg.. 

Btueworid Communications.. 

Bowrs Devebpfnenl......... 


BMnq An Ddranet. Connecf Your Intartef w Vendors/Ck^tomers.. 
Bmgie Software ——........... 


.. 29 

. .12 

.9 

. 24 

..19 


Java in a NutshdS, 2nd BM)n............ 

JavaScript f.t Devdoper's Guide .. 

JavaScript hr the MarMosh............... 

JavaScrpi & Netscape Wdardr/. .. 

JavaScript For The Word Wide lAfeb.. 


....28 

....27 


......25 

......26 


C++ Ffograrmiing with CodeW^mr.. . 

estivate 4.6 Essential Graf^ics Utilities.. 

Cetestin Company........ 

GGi Toolkit....... 

Classic Arcade ...........___ 

ClipVR™.... 


......27 

_18 

.......7 

_13 

......19 

......18 


GodeBuikler........ 

CodeWariior Discover Programming Editio__ 

_ -....-5,8 

____ a. 

CodeWanior for BeOS __—„ 


CodeWanior for PalmRIot Release 4.. 

GodeWarrior LAtrtuHe .. . . .. 

... --? 

CodeWanrior Professional &_ 

A 

Code^A^rhor Software Devdopment Using PowerPiant . 
Gonix Graphics.............. 

CvherStudio... .... . . .. 

...—.27 

............11 

___ 15 IS 


1_=5=^_1 


Joy Exptofier..-.—_-.. .., ., 

j.iii,. 

Jov Devolooer........ ... .... 

. . . . ... fi 


Kaidan.—.......... 

KiWi_ .. .. .. .... __ .... .... 

..._.t6-17 

_ _17 

KiWi flnril kiWi^ Aor^nQorut^ . 

17 

KiWi+ Detent Discs.-.*.-_ _ _ 

__17 


.17 

KiWi BraokAt_^ 

17 

KiWi QuickTilt Leveler... « 



KtWi-to-KiWl+ Upgrade... 


„17 


DOLE Devebper'i^ Odde .... 

DeBade^,....... 

Dd)ugging Madntosh Software with MacsBug . 


....23 

....25 

....24 


Lakewood Software...... 

.......10,18 

La!!«AO 2 S „ 

15 

Late Night Software Ltd....... 

14 

Learn Con The Macinto^ Second Edition............... 

....—.. 27 

Lkiux Confiatjra^an & instaSation. 3rd . 

_ __25 


-M- 

MtfloAAriAn 

. - 7 

Macintosh Common Lisp 4.™ » 

™ - 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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fcr Drador..... 

A4^Tac/)«> f-12 ... 

M^Tech^ Magazine ................ 

MacTech0 Mouse Pad 
Magellan Accessones., 

Magellan QC ........... 


.. 26 

.... 21 

.. .21 

---20 


Royal Softwara, Inc.. 


..14 

_13 


....ie 

...16 


Script Debugger , 
Scripter 2.0........... 


..14 

..14 


Magellan OC Pedestal Set...-.- - 

. ifi 

Seapine Software, he..... 

SmoirnalkAgents for Macintosh „-hh 

___________ ..-..9 

..-.-.. 5 

MsqreaibteSoftwam..... .. .......... ....... 


Main Event Softwam........ 

.. 

....14 

Smartoode Software..... 

... ......8.12 

Mainstay......... ..... . . 

A 1;^ 

nn-Hf»M. 

..-... . in 

Mango Tree Software .............. 

...14 

Sophisticated Cfccuits,---- 

... 6 

Uan^imrtri THlriJjy Rrt¥ ^At , nrmiiTmrniiiii-T niriirmriDI iiiit 

. _ _ 19 

Spedai fiUtion UskTg CGi. .. 

...... .. 28 

Maxum Development .... 

.....13 

SpotCheok.. ___ 

6 

Media Cleaner Pro .. nnr- :ii.iiiinjuo-iinri-:ir»ii[.iifiririTmnmTiniinmTi 

———.18 

SfxttfighI .. . 

. .. ......7 

Memory Min" .li.iiHiiiiiiiiiii 

_ _ - . _ 10 

Staz Software 

... . . .... 10 

" Metiowerks .......... 

..2, 3.20 

Step-Up In^italler Pank....!................ 

...... .... .. .... ....M 

MkLlnux: Microkomel Linux for the Power Macihtoah—— 

___ ^.4 

StepUp Software...... 

...........,a 

Morph......... 

14 

<;t™Tahia daxmon 

.. . ... - .7 

MulliWare Multimedia Coltection.,.,..,.,,....^,-^,,,.—,,. 

..10 

StoneTabiel PutjSshing.... 



Music Tracks.. 


MW Visual SourceSafe Release S... 
Myth The Fallen Lords. 


..10 

....2 

..19 


Super Analyst.. 
SuperPlotPBO 
SuperSoft. 

Symantec_ 


..10 

-10 

....to 

_4 


Symantec Vbuat Cate SburDsbook... 


...^ 


Neon Soflware.. 
NewtCard........ 

Musk Traicks... 


NetMInder Ethernet.- 
Nodester., 

NS BASIC Corporation.. 

NS BASIC 3.6 for the Newton.. 


__15 

, . , . ,:,„ i r n M : ...18 

_____.6 


_15 

...5. 15 


TCP/IP Scri|ltiiig Addttk>n... 

Teach vturself Java forA^aciTfosh fv2l £teys..,..„,..... 

Techwoilo_...................................................................... 


OC^f-Onienteflf Plr^gramm^ and Objoctive C.... .... ,,.......23 

ObiectMaster Professional Edition....S 

ObiectSot Mail SDK.........0.12 

Onyx Technotogy Irx:. ...........7 

OpenOL for the Macintosh _______. _......11 

QofifrJi^ing Pnwwf^ Coda: Programming Ihe PowerPC te Assemfii^ Language . .....26' 


PageCharmer 1.0_ 13 

Panffnation.............. 15 

Rctonus Inc. .............13 

Pilot Attach^ Disk 1...^._ .9 

Podeum Sport...*........... 

..—.13 

_10 

.6 


Terxxi hlersystems..... 

Terran Inteiadive....... 

TestTrack-Bug Trackirig Macintosh Wisiy- 

TTie Java Cte Ltones. Sscmcf Edition, Vokime 2... 
Jhe Java FAQ ............. 

The Offibia/ BBEdt Book ... .... 

Jhe OpenGL Programnmg Guide ...... 

The Way Computer Graphics I4terfcs.., 

Tools Plus libraries + fraTTiBwo?1e.„, 

Tricks of The Mac Game Pmgmmming Gurus .. 


UNi SCFTWARE PLUS....... 

Uahg PDF 2.1 w/ OPBiSJFP (Mach & W&xtewa;/... 


—-.14 

..25 

_19 

-.5, a. 13 
_18 

.. .22 

.22 

... 24 

. 22 

.21 


_...29 


.7 

...23 


Power MachTen 4.0.3............................. 

PowerSD...... 

PowerKey Pro Model 200,600.. 

Pratbc^ Ot:^r-Ortsnfed Oevstepmenr h C++ and Java...........24 

Prefab Software. Inc..............14 

Prime Time Frefwera.,., ............................, ,4 

Pro Fortran __—__—____________—»3 

Progamrrm^s Toc^xAssismi OD-POM.............,.,...26 


VIP-BASfC: Visual Interacirve Programming In BASIC.. 
V1P-C: Visual tntefactive Programming in C ................. 

Visual CaSe for Java ProlessionaJ Development Edtion.. 

Visual Cafe for Java Database Devetopment Edtion --- 


.....4 

.....4 


Visual MacStandardBasic 3>0.»—___—_ 

w>fiDori 1 fl... 



_^7 


-w- 

Voter's Edge Software.............. 

yiteb Rjshfeher's Oea^ Guteb for Macintosh, End (EdfCJn 



..9 

. 26 

ywab Security Sourcdxx^k. ...... 




web Ware „ „„ _ ™. 





WebMaster in a Ate/s/fet Deiuxe Edtion... .. 


26 

.23 


Qjflsar Knowtedge Systems. Inc. ... 

QukkF^n Counterwelghtirig kh' . . ■. i . .! i i_ . 



. ia 

in 


_ _15 

rto*«i* UUhuJ . 

. . .„„J6 



QuickPan 

Quick Pan Mngntim 

,.... ,, , ifi 

Wreiess FdThe Newton. . . .. . . 

.27 

16 

Whiichg wi tt'A^tfarPi fkAifY FOFj ......................... __ 

23 

QuickPan QuickTlIt Leveter .......................................__ 




QuickTime VR Authoring Sludio, Kaklan Bundle .. - 

.. 16 





Xolain Comcfation ....... 

.„»20.21.27 


Rach, Inc. ............ 


■ 



f;: Rjap^jdy Oevdoprx's Guide...... ........... ...24 


ZCUfVB Software.. 


..7 

/ 


■ ■ 
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APS HltSH^PERFORMAftCE ULTRA SCSf DRIVES 


Model 


Ini SR200D 


APSQ200D Quantum RrcballST; 207m 54K *199^ ^219” ^289” 

APS Q 3000 Quantuin Rreball SX3l!BMB/5.4K 223*^ 24^^ 319^ 343^ 

APS 014000 Quantum RrebflB ST.4l36MeA4K 273*’ 299^ ZW 399^ 

APS Q 6400 [liianturiRreballST.e236MBJ.4k 359" 379^ 449® 479® 

APS Q 4300 Quantum Anas IH341WIS, 7300 fpm 499" 569" 539*^ 

APS Q 9000 QuanUimAllasliaB62MB.72BGr|Uii 79^ 869® 899*' 

APS ST 2000 SaapEa Barfacudf,1157IVtB.T21»rpm 379*'^ 449^ 479® 

APS ST 4300 SsaptD Barracuda, 43WB, 7200 rpm 549® 619®^ 649® 

APS ST 4500 S0aflatu ChiH!tah.434aMBJDOa0rTim 649® N/A 749® 

APSST90M SaaflateBarracuda.Sfi^NtSjZDOrpm 779® 849® 87^ 

APS ST 91W SaagaftB ChmtahLOfiSlWB.TOOOOrpni 999® N/A 1,099* 

APS WD 2000 Wastgrn Qigrtal Enturprip, 73Q£1 rpm 379® 449" 479® 

APS VliD 4300 Wftsrefn Digrtat Enlftrpnsfi, 7200 rpm 579® 649" 679* 


6 ^ Tn Drives to Suckn! 

Prices in Red are BatlkM Order online @ http://www.apstech.coiii 

Mm Bmkup'€$34AVsl 

APS HvMrQie ■ 


1 APS HIGH PERFORMANCE ULTRA SCSI RRIVES I 

T9M 

Description 

Fall Height 

APS ST 23000 
APSST23000W 

Sas^ati Biro 23. £1IGB, 54I1D rpm 
Seage(EsEliro23,22.m 541]Drpm 

'1,799* 

1,839« 

APS ULTRA WIDE SCSI DRIVES 

Model 

Description Int SR ZOOQ fro 

APS Q 4300 W 

QurnTtiim Atigs 11,011 MS, 72110 rpm ^29® 

'599* *629* 


N/A 

499* 


A P S Q 4500 W Quantum Vikii^ 4145MB. 7200 fpm 579® 

APS Q 9000 W Quantum ACas 11, gSBZMS, 72® rpm 829* 

APS ST 2000 W SaegatB BarraCPda, 21S7MB, 7200 Qmr 399* 

AP S ST 4300 W SuagMs Ba rr aeuda, 43WM B, 7200 rpm 57 9® 

A PS ST 4500 W Seaptfi Cheelah, 434SM B, tO.DCO rpm 699* 

A PS ST 9000 W Seagate Ba rracuda, 86e5M B, IWb rpm 799® 

APS ST 9100 W Suagate Cheatah, 96aHWB. liyiOD rpm 1,049® 

APS WD 2000 W Western Diglal EnlerpfiseJ300 rpm 429*' 

APS W13 4300 W Western Difiital Entefpfise. 72D0 ipm 599" 


HyperQIC* 

The best value in a high peiformance tape backups 
systemi The APS HyperQIC uses reliable, Indus try- 

standaidTtavaii4tapecaftiidgesto backup up to __ J 

8GB* of data on one tape. ^ 

fiyp«[QlC Starter Kit ' ' . . . 

llncliKlft three TR'4 nrtrid^|ps, one rMw deanef fat) part 1 106625 ...... .S 119.95 

'Assumes 2:1 data compitsilon 

VpgraUbig to Sptm 8,1? 

7 \aorciing to Apple, before you can take advantage of the imptoved hard disk management 
of Mac OS 8J, you mit%i Uck up tlie entire contents of yooi drive. The APS HyperQIC m 
the portable, stackable SR 2000 enclosure is the most economical way to do that. 


Endosiife 


U 



1 APS IDE DRIVES I 

Model 

Descrip^n 



Iniemal 

APS Q 3000 

Qwemtifln Fr^ball SI 3118MB, 5W(I rpm 


*199^ 

APS Q 4000 

Quarttroin FrefraH ST. 4136MB, 5400 rpm 


249^^ 

APS Q 6400 

QuanUftn Hrebeil ST, 6236MB, 5400 rpin 


329^ 

1 APS POWERBOOK STORAGE 1 

Model 

Descriiilian 



Intenal 

APS T 2000 

iQshtoa MKZiroMAV,. 2067MB. 4200 rpm IDE 


^93^ 

1 APS REMOVABLE DRIVES 1 

Model 

DescripUiM 

SB IQOQ 

SHTm 

Pro 

APS SQ 5200 

SvUuestHDG.lOQMfl 

N/A 

^389* 

N/A 

APSJaz 

(widtl QtnridgellGB 

*399® 

2W 

^449® 

APSJazll 

IwiUt 1 canrdfl^lZBB 

649® 

643”' 

699® 

1 APS MO DRIVES 1 

Model 

Dtscfipiiiin 

SR 1000 

Sfl2(»0 

Pro 

APS 230 MO 

Iwfth 1 cartfklge) 217MB 

*299^ 


*339® 

APS 640 MO 

Fujitsu M2613AZ#N 

N/A 

419® 

449® 

APS 2.6GB MO 

S6FlvSIV(O'FM4,l4e0 

N/A 


1,693® 


APS CD-flOM DRIVES 




Model 

D#8^pifien 



Extefnal 

APS CD32 

aax CD-ROM fuSlimnn&Cas* 



^179®^ 


;ve on the APS HyperDAT* 

■ Up to SGB on a single 12am DAT tape** 

■ Induries Mac/PC/NT backup software 
Now just IS99.9S in the APS Pro enclosure! 

-- ^ ■'-' ^AsSimes i) dala cdmprpsitm 

taiffti OAT Smt sSifulSs Sit HAT lapra. wit DAT be*! dewBr. erne labelOiioe DAT aanti ISh one (ttiwllsiii utmige otfw) pjfl * 


s 

"HL Tm 
Jemiifei, 
Call raer 


.m.% 


APSJAZ 

■ Macworld 
Editors^ Choice ^ 

■ liugelGii 
capacity' on 
removable media 


APS ECONOMY 

I I\irfectitpiaceii>Hil drive 
I No e.xpensivc extras 
that you donT need 


Enclosfift 


APS CD 32 

i 32X for fluid miilt|medis! 
■ PastesLCD-ROM"> 
drive ever from Air. 

esse does Mof (MfM 
bat does came with IM ImHinaftif. 


CflStr^ 


SRIVEi 



APS CD Changer 
APS CD-R Plus 
APSCD^RPro 
APS CD-R Pro 
APS CD-RW 
APSCD^RWPro 
APS Jaz/CD-R System 
APS2GB/CD-RWSys. 


NaStammtii 5 Disc/l6X QQ-RBM. Pfg Casa ortly 

2Xi0cnrWEXrftadCB-RISniiyJ 

4X TB cQfd/SX n&ad CO-R m fro EnEtnsura 

4X rHcordffiX read CO-fi in Fuli Height EndostjrB 

2Xf0COtd/6X read CD-RW in Pra Endasure 

4X rscord/EX reanVTX f$wnte CD-RW, Pro Endasura 

ZXroeofdTBXreadCO-R 

OaOMHard Drivs& 2 Kr 0 Cor(tflXreadCB-RW 


Mwf/laWe in on SR MB ftctaiatre tor sn ofitfHMSS&.OG 


maC 


APS HyperQIC^ 
APS HvperDAP i 
APS HyperOAT^Pf 
APS HyperOArni 
APS Mini Library 
APSDLT30 
APSDLT40 
APS DLT70 
APS AIT* 

APSDL1 


Dascriptian 

Imemal 

Travan* Conner QEC309S,8CB 


l’DDS-2DC,8CB 

543* 

DDS-2DC,flJGB 

843^ 

DDS-3DC,ZtGe 

1,143'" 

4nnm DOS-2 AutuLoadir, 64GS: 

N/A 

DLT 3000,30GB 

N/A 

DLT4aM,4t]GB 

N/A 

DLT7DO0,10GB 


BmmW/DC, 80CB 

N/A 

4MMUD$-2 Autoloader. 136GB 

dtaw f:wn ^rwiprf 

N/A 
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379® 

529® 

729® 

529* 

599* 

799® 

899® 


External 



599® 

899^ 

1,19^ 

2,399* 


6,399® 

3,199® 

4,999® 


APSQ2000E 
APSQ3009EI, 

APS ti 400(1 EL 
APSQ640flEL 
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APSQ4300W 

I ProducUviiy boost 
forcreatives 

■ Faster transfers with«. 

Uitra Wide SCSI X „ 

57pt.iMrrf in AT^S P/u £ftriosWJr 

PCI ULTRA WIDE SCSI , MW*' 
HOST ADAPTER ^ ^ 

ADAFTOPOWERDOMAIN’ 

74407rW MAP 

Wlthlhf [Hjrrtaif dtany' AK Lllra Vfiiie.ra tlilw 

Mx QSi a iigi^ (jiTpJq 4^ litiitifeff R 

it ClwMnl'x^ sHK^rR^MtowtovDoin^ 

I tjUcmLtn., 

' JklpliircvT; 
ffiDala W BiMj flWif 1 
' hfiBirfipiwtat 


APSCD-RWPro$ie|IA95 

1 Work faster wilh 4x . 

_ record, 2x remite & ' FjirifMwiit 

6,k read speeds , _ _ . 

■ Ea.^tist rewrihibk —pr-p^ 

CD technology Wl 
available! ^JjL 1 

$490^1 




APS Q43(K) 

^ ^ j? ijerfomiance 
corporate 

$ applications 

7200 rpm Ultra 
SC,SI niechanism 


Coll 800-761 >8133 

Corporate Soles (800) 554-3941 
International (816) 920-4109 

APS Technologies ■ 6l Jl Deramus - G[y^ MO 64120 

Order from Our Online Catalog® 
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IT'S BIGGER. TOUGHER, FASTER 


CodeWarrior Pfofessional Aelease 2. 


Just out and 


ne-ady for some seriausi industrial-strength -programming. Thi 
is the only Integrated Development Environment that allous 
you. to edit-I compile and debug C-i Java and Pascal program 

for iTvultiple target processors and operating systems- We're 
still the code wr iter'-s best friend and now we're better tha 
ever-Here'swhys 


Xportable. project files — may be used interchangeably 
between PIAC and Windows platforms 


X'vfile compare and merge 


select two files to graphically 


view differences and merge changes 


X browse across subprojects — sc 
across targets and subprojects 


source code_b r q wser works 


You can co^unt on CodeWarrior Professional Release 2- WeVe 
powerful-! prove nn easy-to^ Handle and we*ve had all our shots 


CodeWarrior 


metrowerks 


www.metrawerk3.cc 













